Your company here — click to reach over 10,000 unique daily visitors

geoipupdate - Man Page

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 /etc/GeoIP.conf otherwise.


Set the number of parallel database downloads.

-h,  --help

Display help and exit.


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.

Exit Status

geoipupdate returns 0 on success and 1 on error.


Typically you should run geoipupdate weekly. On most Unix-like systems, this can be achieved by using cron. Below is a sample crontab file that runs geoipupdate on each Wednesday at noon:

# top of crontab


0 12 * * 3 geoipupdate

# end of crontab

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 <support@maxmind.com>.


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.

More Information

Visit our website (https://www.maxmind.com/en/geoip2-services-and-databases) to learn more about the GeoIP2 databases or to sign up for a subscription.

See Also


Referenced By

GeoIP.conf(5), geoiplookup(1), geoiplookup6(1).