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 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
/etc/GeoIP.conf.
- -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.
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
[email protected]
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 <
[email protected]>.
Written by William Storey.
This software is Copyright (c) 2018-2022 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 (
https://www.maxmind.com/en/geoip2-services-and-databases) to
learn more about the GeoIP2 databases or to sign up for a subscription.
GeoIP.conf(5)