geoipupdate1

Usage

Overview

geoipupdate automatically updates GeoIP and GeoLite 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.

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.

-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.

Exit status

geoipupdate returns 0 on success and 1 on error.

Notes

Typically you should run geoipupdate at least twice a week. Consult our database release schedule ⟨https://support.maxmind.com/knowledge-base/articles/download-and-update-maxmind-databases⟩\c 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 ⟨https://dev.maxmind.com/geoip/updating-databases/#3-run-geoip-update⟩\c .

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.

More information

Visit our website ⟨https://www.maxmind.com/en/solutions/ip-geolocation-databases-api-services⟩\c to learn more about the GeoIP databases or to sign up for a subscription.