Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages
geoipupdate(7) FreeBSD Miscellaneous Information Manual geoipupdate(7)

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

Written by William Storey.

This software is Copyright © 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 <> to learn more about the GeoIP2 and GeoIP Legacy databases or to sign up for a subscription.


Search for    or go to Top of page |  Section 7 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.