"Fossies" - the Fresh Open Source Software Archive

Member "geoipupdate-4.3.0/doc/geoipupdate.md" (16 Apr 2020, 2160 Bytes) of package /linux/misc/geoipupdate-4.3.0.tar.gz:

As a special service "Fossies" has tried to format the requested source page into HTML format (assuming markdown format). Alternatively you can here view or download the uninterpreted source code file. A member file download can also be achieved by clicking within a package contents listing on the according byte size field. See also the last Fossies "Diffs" side-by-side code changes report for "geoipupdate.md": 4.1.5_vs_4.2.0.


geoipupdate - GeoIP2, GeoLite2, and GeoIP Legacy Update Program


geoipupdate [-Vvh] [-f CONFIG_FILE] [-d TARGET_DIRECTORY]


geoipupdate automatically updates GeoIP2, GeoLite2, and GeoIP Legacy 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 any DatabaseDirectory set in the configuration file.

-f, --config-file

: The configuration file to use. See GeoIP.conf and its documentation for more information. This is optional. It defaults to CONFFILE.

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


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 or set the http_proxy environment variable.


Report bugs to support@maxmind.com.


Written by William Storey.

This software is Copyright (c) 2018-2020 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 and GeoIP Legacy databases or to sign up for a subscription.