geoipupdate(1)

25 Sep 2013

geoipupdate

Update GeoIP2 and GeoIP Legacy binary databases from MaxMind

GeoIP

Library for country/city/organization to IP address or hostname mapping

NAME

geoipupdate - GeoIP2, GeoLite2, and GeoIP Legacy Update Program

SYNOPSIS

B]geoipupdateR] [-Vvh] [-f I]CONFIG_FILER]] [-d I]TARGET_DIRECTORYR]]

DESCRIPTION

C]geoipupdate

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

OPTIONS

`C]-dR],` `C]--database-directoryR]`
	Install databases to a custom directory. This is optional. If provided, it overrides any `C]DatabaseDirectoryR] set in the configuration file.`
`C]-fR],` `C]--config-fileR]`
	The configuration file to use. See `C]GeoIP.confR] and its documentation for more information. This is optional. It defaults to /etc/GeoIP.conf.`
`C]-hR],` `C]--helpR]`
	Display help and exit.
`C]--stack-traceR]`
	Show a stack trace on any error message. This is primarily useful for debugging.
`C]-VR],` `C]--versionR]`
	Display version information and exit.
`C]-vR],` `C]--verboseR]`
	Enable verbose mode. Prints out the steps that `C]geoipupdateR] takes.`

EXIT STATUS

C]geoipupdateR] returns 0 on success and 1 on error.

NOTES

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

C]
# top of crontab


MAILTO=your[at]email.com


0 12 * * 3 geoipupdate


# end of crontab
R]

To use with a proxy server, update your C]GeoIP.confR] file as specified in the C]GeoIP.confR] man page or set the C]http_proxyR] environment variable.

BUGS

Report bugs to <support>.

AUTHORS

Written by William Storey.

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 and GeoIP Legacy databases or to sign up for a subscription.

REFERENCED BY

geoip.conf(5), update-geoip-database(8)