geoipupdate - GeoIP2 and GeoLite2 Update Program
Contents
Bugs
Report bugs to support@maxmind.com.
Description
geoipupdate automatically updates GeoIP2 and GeoLite2 databases. The program connects to the MaxMind
GeoIP Update server to check for new databases. If a new database is available, the program will
download and install it.
If you are using a firewall, you must have the DNS and HTTPS ports open.
Exit Status
geoipupdate returns 0 on success and 1 on error.
More Information
Visit our website to learn more about the GeoIP2 databases or to sign up for a subscription.
Name
geoipupdate - GeoIP2 and GeoLite2 Update Program
Notes
Typically you should run geoipupdate at least twice a week. Consult our https://support.max‐
mind.com/hc/en-us/articles/4408216129947-Download-and-Update-Databas‐ es#h_01G3XX402XKD3J1CMWKNKMDYYZ
database release schedule for more information.
On most Unix-like systems, this can be achieved by using cron. You can find an example crontab file on
our Developer Portal.
To use with a proxy server, update your GeoIP.conf file as specified in the GeoIP.conf man page.
Alternatively, set the GEOIPUPDATE_PROXY or http_proxy environment variable.
Options
-d, --database-directory
Install databases to a custom directory. This is optional. If provided, it overrides the
DatabaseDirectory value from the configuration file and the GEOIPUPDATE_DB_DIR environment
variable.
-f, --config-file
The configuration file to use. See GeoIP.conf and its documentation for more information. This
is optional. It defaults to the environment variable GEOIPUPDATE_CONF_FILE if it is set, or
/etc/GeoIP.conf otherwise.
--parallelism
Set the number of parallel database downloads.
-h, --help
Display help and exit.
--stack-trace
Show a stack trace on any error message. This is primarily useful for debugging.
-V, --version
Display version information and exit.
-v, --verbose
Enable verbose mode. Prints out the steps that geoipupdate takes. If provided, it overrides any
GEOIPUPDATE_VERBOSE environment variable.
-o, --output
Output download/update results in JSON format.
See Also
GeoIP.conf(5) geoipupdate(1)
Synopsis
geoipupdate [-Vvh] [-f CONFIG_FILE] [-d TARGET_DIRECTORY]
