1GeoIP.conf(5) GeoIP.conf(5)
2
3
4
6 GeoIP.conf - Configuration file for geoipupdate
7
9 This file allows you to configure your geoipupdate program to download
10 GeoIP2 and GeoLite2 databases.
11
13 The file consists of one setting per line. Lines starting with # are
14 comments and will not be processed. All setting keywords are case sen‐
15 sitive.
16
17 Required settings:
18 AccountID
19 Your MaxMind account ID. This was formerly known as UserId.
20 This can be overridden at run time by either the GEOIPUPDATE_AC‐
21 COUNT_ID or the GEOIPUPDATE_ACCOUNT_ID_FILE environment vari‐
22 ables.
23
24 LicenseKey
25 Your case-sensitive MaxMind license key. This can be overridden
26 at run time by either the GEOIPUPDATE_LICENSE_KEY or GEOIPUP‐
27 DATE_LICENSE_KEY_FILE environment variables.
28
29 EditionIDs
30 List of space-separated database edition IDs. Edition IDs may
31 consist of letters, digits, and dashes. For example,
32 GeoIP2-City would download the GeoIP2 City database
33 (GeoIP2-City). This can be overridden at run time by the
34 GEOIPUPDATE_EDITION_IDS environment variable. Note: this was
35 formerly called ProductIds.
36
37 Optional settings:
38 DatabaseDirectory
39 The directory to store the database files. If not set, the de‐
40 fault is /usr/share/GeoIP. This can be overridden at run time
41 by the GEOIPUPDATE_DB_DIR environment variable or the -d command
42 line argument.
43
44 Host The host name of the server to use. The default is updates.max‐
45 mind.com. This can be overridden at run time by the GEOIPUP‐
46 DATE_HOST environment variable.
47
48 Proxy The proxy host name or IP address. You may optionally specify a
49 port number, e.g., 127.0.0.1:8888. If no port number is speci‐
50 fied, 1080 will be used. This can be overridden at run time by
51 the GEOIPUPDATE_PROXY environment variable.
52
53 ProxyUserPassword
54 The proxy user name and password, separated by a colon. For in‐
55 stance, username:password. This can be overridden at run time
56 by the GEOIPUPDATE_PROXY_USER_PASSWORD environment variable.
57
58 PreserveFileTimes
59 Whether to preserve modification times of files downloaded from
60 the server. This option is either 0 or 1. The default is 0.
61 This can be overridden at run time by the GEOIPUPDATE_PRE‐
62 SERVE_FILE_TIMES environment variable.
63
64 LockFile
65 The lock file to use. This ensures only one geoipupdate process
66 can run at a time. Note: Once created, this lockfile is not re‐
67 moved from the filesystem. The default is .geoipupdate.lock un‐
68 der the DatabaseDirectory. This can be overridden at run time
69 by the GEOIPUPDATE_LOCK_FILE environment variable.
70
71 RetryFor
72 The amount of time to retry for when errors during HTTP transac‐
73 tions are encountered. It can be specified as a (possibly frac‐
74 tional) decimal number followed by a unit suffix. Valid time
75 units are ns, us (or µs), ms, s, m, h. The default is 5m (5
76 minutes). This can be overridden at run time by the GEOIPUP‐
77 DATE_RETRY_FOR environment variable.
78
79 Parallelism
80 The maximum number of parallel database downloads. The default
81 is 1, which means that databases will be downloaded sequential‐
82 ly. This can be overridden at run time by the GEOIPUPDATE_PAR‐
83 ALLELISM environment variable or the --parallelism command line
84 argument.
85
86 Deprecated settings:
87 The following are deprecated and will be ignored if present:
88
89 Protocol
90
91 SkipPeerVerification
92
93 SkipHostnameVerification
94
96 geoipupdate(1)
97
98
99
100 GeoIP.conf(5)