GeoIP.conf - Man Page
Configuration file for geoipupdate
Synopsis
This file allows you to configure your geoipupdate program to download GeoIP2 and GeoLite2 databases.
Description
The file consists of one setting per line. Lines starting with # are comments and will not be processed. All setting keywords are case sensitive.
Required settings
- AccountID
Your MaxMind account ID. This was formerly known as
UserId. This can be overridden at run time by either theGEOIPUPDATE_ACCOUNT_IDor theGEOIPUPDATE_ACCOUNT_ID_FILEenvironment variables.- LicenseKey
Your case-sensitive MaxMind license key. This can be overridden at run time by either the
GEOIPUPDATE_LICENSE_KEYorGEOIPUPDATE_LICENSE_KEY_FILEenvironment variables.- EditionIDs
List of space-separated database edition IDs. Edition IDs may consist of letters, digits, and dashes. For example,
GeoIP2-Citywould download the GeoIP2 City database (GeoIP2-City). This can be overridden at run time by theGEOIPUPDATE_EDITION_IDSenvironment variable. Note: this was formerly calledProductIds.
Optional settings
- DatabaseDirectory
The directory to store the database files. If not set, the default is /usr/share/GeoIP. This can be overridden at run time by the
GEOIPUPDATE_DB_DIRenvironment variable or the-dcommand line argument.- Host
The host name of the server to use. The default is
updates.maxmind.com. This can be overridden at run time by theGEOIPUPDATE_HOSTenvironment variable.- Proxy
The proxy host name or IP address. You may optionally specify a port number, e.g.,
127.0.0.1:8888. If no port number is specified, 1080 will be used. This can be overridden at run time by theGEOIPUPDATE_PROXYenvironment variable.- ProxyUserPassword
The proxy user name and password, separated by a colon. For instance,
username:password. This can be overridden at run time by theGEOIPUPDATE_PROXY_USER_PASSWORDenvironment variable.- PreserveFileTimes
Whether to preserve modification times of files downloaded from the server. This option is either
0or1. The default is0. This can be overridden at run time by theGEOIPUPDATE_PRESERVE_FILE_TIMESenvironment variable.- LockFile
The lock file to use. This ensures only one
geoipupdateprocess can run at a time. Note: Once created, this lockfile is not removed from the filesystem. The default is.geoipupdate.lockunder theDatabaseDirectory. This can be overridden at run time by theGEOIPUPDATE_LOCK_FILEenvironment variable.- RetryFor
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
ns,us(orµs),ms,s,m,h. The default is5m(5 minutes). This can be overridden at run time by theGEOIPUPDATE_RETRY_FORenvironment variable.- Parallelism
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
GEOIPUPDATE_PARALLELISMenvironment variable or the--parallelismcommand line argument.
Deprecated settings
The following are deprecated and will be ignored if present:
Protocol
SkipPeerVerification
SkipHostnameVerification