.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "GeoIP.conf" "5" "" "" ""
.hy
.SH NAME
.PP
GeoIP.conf - Configuration file for geoipupdate
.SH SYNOPSIS
.PP
This file allows you to configure your \f[C]geoipupdate\f[R] program to
download GeoIP2, GeoLite2, and GeoIP Legacy databases.
.SH DESCRIPTION
.PP
The file consists of one setting per line.
Lines starting with \f[C]#\f[R] are comments and will not be processed.
All setting keywords are case sensitive.
.SS Required settings:
.TP
\f[B]\f[CB]AccountID\f[B]\f[R]
Your MaxMind account ID.
This was formerly known as \f[C]UserId\f[R].
.TP
\f[B]\f[CB]LicenseKey\f[B]\f[R]
Your case-sensitive MaxMind license key.
.TP
\f[B]\f[CB]EditionIDs\f[B]\f[R]
List of space-separated database edition IDs.
Edition IDs may consist of letters, digits, and dashes.
For example, \f[C]GeoIP2-City 106\f[R] would download the GeoIP2 City
database (\f[C]GeoIP2-City\f[R]) and the GeoIP Legacy Country database
(\f[C]106\f[R]).
Note: this was formerly called \f[C]ProductIds\f[R].
.SS Optional settings:
.TP
\f[B]\f[CB]DatabaseDirectory\f[B]\f[R]
The directory to store the database files.
If not set, the default is /var/lib/GeoIP.
This can be overridden at run time by the \f[C]-d\f[R] command line
argument.
.TP
\f[B]\f[CB]Host\f[B]\f[R]
The host name of the server to use.
The default is \f[C]updates.maxmind.com\f[R].
.TP
\f[B]\f[CB]Proxy\f[B]\f[R]
The proxy host name or IP address.
You may optionally specify a port number, e.g.,
\f[C]127.0.0.1:8888\f[R].
If no port number is specified, 1080 will be used.
.TP
\f[B]\f[CB]ProxyUserPassword\f[B]\f[R]
The proxy user name and password, separated by a colon.
For instance, \f[C]username:password\f[R].
.TP
\f[B]\f[CB]PreserveFileTimes\f[B]\f[R]
Whether to preserve modification times of files downloaded from the
server.
This option is either \f[C]0\f[R] or \f[C]1\f[R].
The default is \f[C]0\f[R].
.TP
\f[B]\f[CB]LockFile\f[B]\f[R]
The lock file to use.
This ensures only one \f[C]geoipupdate\f[R] process can run at a time.
Note: Once created, this lockfile is not removed from the filesystem.
The default is \f[C].geoipupdate.lock\f[R] under the
\f[C]DatabaseDirectory\f[R].
.TP
\f[B]\f[CB]RetryFor\f[B]\f[R]
The amount of time to retry for when errors during HTTP transactions are
encountered.
It can be specified as a (possibly fractional) decimal number followed
by a unit suffix.
Valid time units are \f[C]ns\f[R], \f[C]us\f[R] (or \f[C]\[mc]s\f[R]),
\f[C]ms\f[R], \f[C]s\f[R], \f[C]m\f[R], \f[C]h\f[R].
The default is \f[C]5m\f[R] (5 minutes).
.SS Deprecated settings:
.PP
The following are deprecated and will be ignored if present:
.PP
\f[C]Protocol\f[R]
.PP
\f[C]SkipPeerVerification\f[R]
.PP
\f[C]SkipHostnameVerification\f[R]
.SH SEE ALSO
.PP
\f[C]geoipupdate\f[R](1)