1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
# NAME
geoipupdate - GeoIP2 and GeoLite2 Update Program
# SYNOPSIS
**geoipupdate** [-Vvh] [-f *CONFIG_FILE*] [-d *TARGET_DIRECTORY*]
# DESCRIPTION
`geoipupdate` automatically updates GeoIP2 and GeoLite2 databases. The
program connects to the MaxMind GeoIP Update server to check for new
databases. If a new database is available, the program will download and
install it.
If you are using a firewall, you must have the DNS and HTTPS ports
open.
# OPTIONS
`-d`, `--database-directory`
: Install databases to a custom directory. This is optional. If provided, it
overrides the `DatabaseDirectory` value from the configuration file and the
`GEOIPUPDATE_DB_DIR` environment variable.
`-f`, `--config-file`
: The configuration file to use. See `GeoIP.conf` and its documentation for
more information. This is optional. It defaults to the environment variable
`GEOIPUPDATE_CONF_FILE` if it is set, or CONFFILE otherwise.
`--parallelism`
: Set the number of parallel database downloads.
`-h`, `--help`
: Display help and exit.
`--stack-trace`
: Show a stack trace on any error message. This is primarily useful for
debugging.
`-V`, `--version`
: Display version information and exit.
`-v`, `--verbose`
: Enable verbose mode. Prints out the steps that `geoipupdate` takes. If
provided, it overrides any `GEOIPUPDATE_VERBOSE` environment variable.
`-o`, `--output`
: Output download/update results in JSON format.
# EXIT STATUS
`geoipupdate` returns 0 on success and 1 on error.
# NOTES
Typically you should run `geoipupdate` weekly. On most Unix-like systems,
this can be achieved by using cron. Below is a sample crontab file that
runs `geoipupdate` on each Wednesday at noon:
# top of crontab
MAILTO=your@email.com
0 12 * * 3 geoipupdate
# end of crontab
To use with a proxy server, update your `GeoIP.conf` file as specified in
the `GeoIP.conf` man page. Alternatively, set the `GEOIPUPDATE_PROXY` or
`http_proxy` environment variable.
# BUGS
Report bugs to [support@maxmind.com](mailto:support@maxmind.com).
# AUTHORS
Written by William Storey.
This software is Copyright (c) 2018-2023 by MaxMind, Inc.
This is free software, licensed under the Apache License, Version 2.0 or
the MIT License, at your option.
# MORE INFORMATION
Visit [our website](https://www.maxmind.com/en/geoip2-services-and-databases)
to learn more about the GeoIP2 databases or to sign up for a subscription.
# SEE ALSO
`GeoIP.conf`(5)
|
