1geoipupdate(1)                                                  geoipupdate(1)
2
3
4

NAME

6       geoipupdate - GeoIP2, GeoLite2, and GeoIP Legacy Update Program
7

SYNOPSIS

9              geoipupdate [-Vvh] [-f CONFIG_FILE] [-d TARGET_DIRECTORY]
10

DESCRIPTION

12       geoipupdate  automatically  updates  GeoIP2, GeoLite2, and GeoIP Legacy
13       databases.  The program connects to the MaxMind GeoIP Update server  to
14       check  for  new databases.  If a new database is available, the program
15       will download and install it.
16
17       If you are using a firewall, you must have  the  DNS  and  HTTPS  ports
18       open.
19

OPTIONS

21       -d, --database-directory
22              Install  databases to a custom directory.  This is optional.  If
23              provided, it overrides any DatabaseDirectory set in the configu‐
24              ration file.
25
26       -f, --config-file
27              The  configuration file to use.  See GeoIP.conf and its documen‐
28              tation for more information.  This is optional.  It defaults  to
29              /etc/GeoIP.conf.
30
31       -h, --help
32              Display help and exit.
33
34       --stack-trace
35              Show a stack trace on any error message.  This is primarily use‐
36              ful for debugging.
37
38       -V, --version
39              Display version information and exit.
40
41       -v, --verbose
42              Enable verbose mode.  Prints  out  the  steps  that  geoipupdate
43              takes.
44

USAGE

46       Typically  you  should  run geoipupdate weekly.  On most Unix-like sys‐
47       tems, this can be achieved by using cron.  Below is  a  sample  crontab
48       file that runs geoipupdate on each Wednesday at noon:
49
50              # top of crontab
51
52              MAILTO=your@email.com
53
54              0 12 * * 3 geoipupdate
55
56              # end of crontab
57
58       To use with a proxy server, update your GeoIP.conf file as specified in
59       the GeoIP.conf man page or set the http_proxy environment variable.
60

RETURN CODES

62       geoipupdate returns 0 on success and 1 on error.
63

FILES

65       · GeoIP.conf - Configuration file for GeoIP Update.  See the GeoIP.conf
66         documentation for more information.
67

AUTHOR

69       Written by William Storey.
70

REPORTING BUGS

72       Report bugs to <support@maxmind.com>.
73

75       This software is Copyright (c) 2018-2019 by MaxMind, Inc.
76
77       This  is  free software, licensed under the Apache License, Version 2.0
78       or the MIT License, at your option.
79

MORE INFORMATION

81       Visit our website (https://www.maxmind.com/en/geoip2-services-and-data‐
82       bases)  to learn more about the GeoIP2 and GeoIP Legacy databases or to
83       sign up for a subscription.
84

SEE ALSO

86       GeoIP.conf(5)
87
88
89
90                                                                geoipupdate(1)
Impressum