geoipupdate - Man Page
GeoIP2 and GeoLite2 Update Program
Synopsis
Description
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.
Options
- -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.- --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.- -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
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 MAILTO=your@email.com 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.
Bugs
Report bugs to <support@maxmind.com>.
Authors
Written by William Storey.
This software is Copyright (c) 2018-2023 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.