1geoipupdate(1) geoipupdate(1)
2
3
4
6 NAME
7 geoipupdate - GeoIP2, GeoLite2, and GeoIP Legacy Update Program
8
9 SYNOPSIS
10 geoipupdate [-Vvh] [-f CONFIG_FILE] [-d TARGET_DIRECTORY]
11
12 DESCRIPTION
13 geoipupdate automatically updates GeoIP2, GeoLite2, and GeoIP Legacy
14 databases. The program connects to the MaxMind GeoIP Update server to
15 check for new databases. If a new database is available, the program
16 will download and install it.
17
18 If you are using a firewall, you must have the DNS and HTTPS ports
19 open.
20
21 OPTIONS
22 · -d, --database-directory - Install databases to a custom directory.
23 This is optional. If provided, it overrides any DatabaseDirectory
24 set in the configuration file.
25
26 · -f, --config-file - The configuration file to use. See GeoIP.conf
27 and its documentation for more information. This is optional. It
28 defaults to /etc/GeoIP.conf.
29
30 · -h, --help - Display help and exit.
31
32 · --stack-trace - Show a stack trace on any error message. This is
33 primarily useful for debugging.
34
35 · -V, --version - Display version information and exit.
36
37 · -v, --verbose - Enable verbose mode. Prints out the steps that
38 geoipupdate takes.
39
40 USAGE
41 Typically you should run geoipupdate weekly. On most Unix-like sys‐
42 tems, this can be achieved by using cron. Below is a sample crontab
43 file that runs geoipupdate on each Wednesday at noon:
44
45 # top of crontab
46
47 MAILTO=your@email.com
48
49 0 12 * * 3 geoipupdate
50
51 # end of crontab
52
53 To use with a proxy server, update your GeoIP.conf file as specified in
54 the GeoIP.conf man page or set the http_proxy environment variable.
55
56 RETURN CODES
57 geoipupdate returns 0 on success and 1 on error.
58
59 FILES
60 · GeoIP.conf - Configuration file for GeoIP Update. See the GeoIP.conf
61 documentation for more information.
62
63 AUTHOR
64 Written by William Storey.
65
66 REPORTING BUGS
67 Report bugs to <support@maxmind.com>.
68
69 COPYRIGHT
70 This software is Copyright (c) 2018-2019 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
75 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
80 SEE ALSO
81 GeoIP.conf(5)
82
83
84
85 geoipupdate(1)