1geoipupdate(1) geoipupdate(1)
2
3
4
6 geoipupdate - GeoIP2, GeoLite2, and GeoIP Legacy Update Program
7
9 geoipupdate [-Vvh] [-f CONFIG_FILE] [-d TARGET_DIRECTORY]
10
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
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
46 geoipupdate returns 0 on success and 1 on error.
47
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
65 Report bugs to <support@maxmind.com>.
66
68 Written by William Storey.
69
70 This software is Copyright (c) 2018-2022 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
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
81 GeoIP.conf(5)
82
83
84
85 geoipupdate(1)