.\" Automatically generated by Pandoc 3.1.8 .\" .TH "GeoIP.conf" "5" "" "" "" .SH NAME GeoIP.conf - Configuration file for geoipupdate .SH SYNOPSIS This file allows you to configure your \f[CR]geoipupdate\f[R] program to download GeoIP2 and GeoLite2 databases. .SH DESCRIPTION The file consists of one setting per line. Lines starting with \f[CR]#\f[R] are comments and will not be processed. All setting keywords are case sensitive. .SS Required settings: .TP \f[CR]AccountID\f[R] Your MaxMind account ID. This was formerly known as \f[CR]UserId\f[R]. This can be overridden at run time by either the \f[CR]GEOIPUPDATE_ACCOUNT_ID\f[R] or the \f[CR]GEOIPUPDATE_ACCOUNT_ID_FILE\f[R] environment variables. .TP \f[CR]LicenseKey\f[R] Your case-sensitive MaxMind license key. This can be overridden at run time by either the \f[CR]GEOIPUPDATE_LICENSE_KEY\f[R] or \f[CR]GEOIPUPDATE_LICENSE_KEY_FILE\f[R] environment variables. .TP \f[CR]EditionIDs\f[R] List of space-separated database edition IDs. Edition IDs may consist of letters, digits, and dashes. For example, \f[CR]GeoIP2-City\f[R] would download the GeoIP2 City database (\f[CR]GeoIP2-City\f[R]). This can be overridden at run time by the \f[CR]GEOIPUPDATE_EDITION_IDS\f[R] environment variable. Note: this was formerly called \f[CR]ProductIds\f[R]. .SS Optional settings: .TP \f[CR]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[CR]GEOIPUPDATE_DB_DIR\f[R] environment variable or the \f[CR]-d\f[R] command line argument. .TP \f[CR]Host\f[R] The host name of the server to use. The default is \f[CR]updates.maxmind.com\f[R]. This can be overridden at run time by the \f[CR]GEOIPUPDATE_HOST\f[R] environment variable. .TP \f[CR]Proxy\f[R] The proxy host name or IP address. You may optionally specify a port number, e.g., \f[CR]127.0.0.1:8888\f[R]. If no port number is specified, 1080 will be used. This can be overridden at run time by the \f[CR]GEOIPUPDATE_PROXY\f[R] environment variable. .TP \f[CR]ProxyUserPassword\f[R] The proxy user name and password, separated by a colon. For instance, \f[CR]username:password\f[R]. This can be overridden at run time by the \f[CR]GEOIPUPDATE_PROXY_USER_PASSWORD\f[R] environment variable. .TP \f[CR]PreserveFileTimes\f[R] Whether to preserve modification times of files downloaded from the server. This option is either \f[CR]0\f[R] or \f[CR]1\f[R]. The default is \f[CR]0\f[R]. This can be overridden at run time by the \f[CR]GEOIPUPDATE_PRESERVE_FILE_TIMES\f[R] environment variable. .TP \f[CR]LockFile\f[R] The lock file to use. This ensures only one \f[CR]geoipupdate\f[R] process can run at a time. Note: Once created, this lockfile is not removed from the filesystem. The default is \f[CR].geoipupdate.lock\f[R] under the \f[CR]DatabaseDirectory\f[R]. This can be overridden at run time by the \f[CR]GEOIPUPDATE_LOCK_FILE\f[R] environment variable. .TP \f[CR]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[CR]ns\f[R], \f[CR]us\f[R] (or \f[CR]µs\f[R]), \f[CR]ms\f[R], \f[CR]s\f[R], \f[CR]m\f[R], \f[CR]h\f[R]. The default is \f[CR]5m\f[R] (5 minutes). This can be overridden at run time by the \f[CR]GEOIPUPDATE_RETRY_FOR\f[R] environment variable. .TP \f[CR]Parallelism\f[R] The maximum number of parallel database downloads. The default is 1, which means that databases will be downloaded sequentially. This can be overridden at run time by the \f[CR]GEOIPUPDATE_PARALLELISM\f[R] environment variable or the \f[CR]--parallelism\f[R] command line argument. .SS Deprecated settings: The following are deprecated and will be ignored if present: .PP \f[CR]Protocol\f[R] .PP \f[CR]SkipPeerVerification\f[R] .PP \f[CR]SkipHostnameVerification\f[R] .SH SEE ALSO \f[CR]geoipupdate\f[R](1)