.TH GEOIPUPDATE 1 "25 Sep 2013" .UC 4 .SH NAME geoipupdate - GeoIP2 and GeoIP Legacy Update Program .SH SYNOPSIS geoipupdate [\-Vvh] [\-f license_file] [\-d target_directory] .SH DESCRIPTION .BR geoipupdate " automatically updates GeoIP2 and GeoIP Legacy databases for MaxMind customers. 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 HTTP(S) ports open. .SH OPTIONS .IP "\-V" Display version information. .IP "\-v" Enable verbose mode. Prints out the steps that .BR geoipupdate " takes. .IP "\-d" Install databases to a custom directory. By default .BR geoipupdate " installs to " /var/lib/GeoIP. .IP "\-f" Use an alternate configuration file. Defaults to .BR /etc/GeoIP.conf ". .SH USAGE Typically you should run .BR geoipupdate " weekly. One way to achieve this is to use cron. Below is a sample crontab file that runs .BR geoipupdate " on each Wednesday at noon: .RS # top of crontab MAILTO=your@email.com 0 12 * * 3 BIN_DIR/geoipupdate # end of crontab .RE To use with a proxy server, update your .BR GeoIP.conf " file as specified in the " GeoIP.conf " man page or set .RB the " http_proxy " environment variable. .SH RETURN CODES .BR geoipupdate " returns 0 on success and 1 on error. .SH FILES .PP .TP .B /etc/GeoIP.conf Configuration file for GeoIP Update. See the .BR GeoIP.conf "(5) man page for more information. .SH AUTHOR Written by T.J. Mather and Boris Zentner. .SH "REPORTING BUGS" Report bugs to . .SH COPYRIGHT Copyright (C) 2013 MaxMind, Inc. This is free software; see the .BR LICENSE " file for copying conditions. There is NO WARRANTY, express or implied, including, but not limited to, NO IMPLIED WARRANTY of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. .SH MORE INFORMATION Visit to learn more about the GeoIP2 and GeoIP Legacy databases or to sign up for a subscription. .SH SEE ALSO .BR GeoIP.conf "(5), "crontab "(5)