.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "geoipupdate" "1" "" "" ""
.hy
.SH NAME
.PP
geoipupdate - GeoIP2, GeoLite2, and GeoIP Legacy Update Program
.SH SYNOPSIS
.PP
\f[B]geoipupdate\f[R] [-Vvh] [-f \f[I]CONFIG_FILE\f[R]] [-d
\f[I]TARGET_DIRECTORY\f[R]]
.SH DESCRIPTION
.PP
\f[C]geoipupdate\f[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.
.PP
If you are using a firewall, you must have the DNS and HTTPS ports open.
.SH OPTIONS
.TP
\f[B]\f[CB]-d\f[B]\f[R], \f[B]\f[CB]--database-directory\f[B]\f[R]
Install databases to a custom directory.
This is optional.
If provided, it overrides any \f[C]DatabaseDirectory\f[R] set in the
configuration file.
.TP
\f[B]\f[CB]-f\f[B]\f[R], \f[B]\f[CB]--config-file\f[B]\f[R]
The configuration file to use.
See \f[C]GeoIP.conf\f[R] and its documentation for more information.
This is optional.
It defaults to /etc/GeoIP.conf.
.TP
\f[B]\f[CB]-h\f[B]\f[R], \f[B]\f[CB]--help\f[B]\f[R]
Display help and exit.
.TP
\f[B]\f[CB]--stack-trace\f[B]\f[R]
Show a stack trace on any error message.
This is primarily useful for debugging.
.TP
\f[B]\f[CB]-V\f[B]\f[R], \f[B]\f[CB]--version\f[B]\f[R]
Display version information and exit.
.TP
\f[B]\f[CB]-v\f[B]\f[R], \f[B]\f[CB]--verbose\f[B]\f[R]
Enable verbose mode.
Prints out the steps that \f[C]geoipupdate\f[R] takes.
.SH EXIT STATUS
.PP
\f[C]geoipupdate\f[R] returns 0 on success and 1 on error.
.SH NOTES
.PP
Typically you should run \f[C]geoipupdate\f[R] weekly.
On most Unix-like systems, this can be achieved by using cron.
Below is a sample crontab file that runs \f[C]geoipupdate\f[R] on each
Wednesday at noon:
.IP
.nf
\f[C]
# top of crontab

MAILTO=your\[at]email.com

0 12 * * 3 geoipupdate

# end of crontab
\f[R]
.fi
.PP
To use with a proxy server, update your \f[C]GeoIP.conf\f[R] file as
specified in the \f[C]GeoIP.conf\f[R] man page or set the
\f[C]http_proxy\f[R] environment variable.
.SH BUGS
.PP
Report bugs to <support@maxmind.com>.
.SH AUTHORS
.PP
Written by William Storey.
.PP
This software is Copyright (c) 2018-2020 by MaxMind, Inc.
.PP
This is free software, licensed under the Apache License, Version 2.0 or
the MIT License, at your option.
.SH MORE INFORMATION
.PP
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.
.SH SEE ALSO
.PP
\f[C]GeoIP.conf\f[R](5)