geoipupdate - GeoIP2 and GeoLite2 Update Program
geoipupdate [-Vvh] [-f CONFIG_FILE] [-d TARGET_DIRECTORY]
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.
-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 CONFFILE 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.
geoipupdate returns 0 on success and 1 on error.
Typically you should run geoipupdate at least twice a week. Consult
our
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.
Report bugs to [email protected].
Written by William Storey.
This software is Copyright (c) 2018-2024 by MaxMind, Inc.
This is free software, licensed under the Apache License, Version 2.0 or the MIT License, at your option.
Visit our website to learn more about the GeoIP2 databases or to sign up for a subscription.
GeoIP.conf(5)