geoipupdate(1)

1geoipupdate(1)                                                  geoipupdate(1)
2
3
4

NAME

6       geoipupdate - GeoIP2, GeoLite2, and GeoIP Legacy Update Program
7

SYNOPSIS

9       geoipupdate [-Vvh] [-f CONFIG_FILE] [-d TARGET_DIRECTORY]
10

DESCRIPTION

12       geoipupdate  automatically  updates  GeoIP2, GeoLite2, and GeoIP Legacy
13       databases.  The program connects to the MaxMind GeoIP Update server  to
14       check  for  new databases.  If a new database is available, the program
15       will download and install it.
16
17       If you are using a firewall, you must have  the  DNS  and  HTTPS  ports
18       open.
19

OPTIONS

21       -d, --database-directory
22              Install  databases to a custom directory.  This is optional.  If
23              provided, it overrides any DatabaseDirectory set in the configu‐
24              ration file.
25
26       -f, --config-file
27              The  configuration file to use.  See GeoIP.conf and its documen‐
28              tation for more information.  This is optional.  It defaults  to
29              /etc/GeoIP.conf.
30
31       -h, --help
32              Display help and exit.
33
34       --stack-trace
35              Show a stack trace on any error message.  This is primarily use‐
36              ful for debugging.
37
38       -V, --version
39              Display version information and exit.
40
41       -v, --verbose
42              Enable verbose mode.  Prints  out  the  steps  that  geoipupdate
43              takes.
44

EXIT STATUS

46       geoipupdate returns 0 on success and 1 on error.
47

NOTES

49       Typically  you  should  run geoipupdate weekly.  On most Unix-like sys‐
50       tems, this can be achieved by using cron.  Below is  a  sample  crontab
51       file that runs geoipupdate on each Wednesday at noon:
52
53              # top of crontab
54
55              MAILTO=your@email.com
56
57              0 12 * * 3 geoipupdate
58
59              # end of crontab
60
61       To use with a proxy server, update your GeoIP.conf file as specified in
62       the GeoIP.conf man page or set the http_proxy environment variable.
63

BUGS

65       Report bugs to <support@maxmind.com>.
66

AUTHORS

68       Written by William Storey.
69
70       This software is Copyright (c) 2018-2020 by MaxMind, Inc.
71
72       This is free software, licensed under the Apache License,  Version  2.0
73       or the MIT License, at your option.
74

MORE INFORMATION

76       Visit our website (https://www.maxmind.com/en/geoip2-services-and-data‐
77       bases) to learn more about the GeoIP2 and GeoIP Legacy databases or  to
78       sign up for a subscription.
79