.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.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[V]geoipupdate\f[R] program to
download GeoIP2 and GeoLite2 databases.
.SH DESCRIPTION
.PP
The file consists of one setting per line.
Lines starting with \f[V]#\f[R] are comments and will not be processed.
All setting keywords are case sensitive.
.SS Required settings:
.TP
\f[V]AccountID\f[R]
Your MaxMind account ID.
This was formerly known as \f[V]UserId\f[R].
.TP
\f[V]LicenseKey\f[R]
Your case-sensitive MaxMind license key.
.TP
\f[V]EditionIDs\f[R]
List of space-separated database edition IDs.
Edition IDs may consist of letters, digits, and dashes.
For example, \f[V]GeoIP2-City\f[R] would download the GeoIP2 City
database (\f[V]GeoIP2-City\f[R]).
Note: this was formerly called \f[V]ProductIds\f[R].
.SS Optional settings:
.TP
\f[V]DatabaseDirectory\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[V]-d\f[R] command line
argument.
.TP
\f[V]Host\f[R]
The host name of the server to use.
The default is \f[V]updates.maxmind.com\f[R].
.TP
\f[V]Proxy\f[R]
The proxy host name or IP address.
You may optionally specify a port number, e.g.,
\f[V]127.0.0.1:8888\f[R].
If no port number is specified, 1080 will be used.
.TP
\f[V]ProxyUserPassword\f[R]
The proxy user name and password, separated by a colon.
For instance, \f[V]username:password\f[R].
.TP
\f[V]PreserveFileTimes\f[R]
Whether to preserve modification times of files downloaded from the
server.
This option is either \f[V]0\f[R] or \f[V]1\f[R].
The default is \f[V]0\f[R].
.TP
\f[V]LockFile\f[R]
The lock file to use.
This ensures only one \f[V]geoipupdate\f[R] process can run at a time.
Note: Once created, this lockfile is not removed from the filesystem.
The default is \f[V].geoipupdate.lock\f[R] under the
\f[V]DatabaseDirectory\f[R].
.TP
\f[V]RetryFor\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[V]ns\f[R], \f[V]us\f[R] (or \f[V]\[mc]s\f[R]),
\f[V]ms\f[R], \f[V]s\f[R], \f[V]m\f[R], \f[V]h\f[R].
The default is \f[V]5m\f[R] (5 minutes).
.SS Deprecated settings:
.PP
The following are deprecated and will be ignored if present:
.PP
\f[V]Protocol\f[R]
.PP
\f[V]SkipPeerVerification\f[R]
.PP
\f[V]SkipHostnameVerification\f[R]
.SH SEE ALSO
.PP
\f[V]geoipupdate\f[R](1)