geoipupdate(1)

1GEOIPUPDATE(1)              General Commands Manual             GEOIPUPDATE(1)
2
3
4

NAME

6       geoipupdate - GeoIP2 and GeoIP Legacy Update Program
7

SYNOPSIS

9       geoipupdate [-Vvh] [-f license_file] [-d target_directory]
10

DESCRIPTION

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

OPTIONS

21       -V     Display version information.
22
23       -v     Enable  verbose  mode.  Prints  out  the  steps that geoipupdate
24              takes.
25
26       -d     Install databases to a custom directory. By default  geoipupdate
27              installs to /usr/share/GeoIP.
28
29       -f     Use    an    alternate    configuration    file.   Defaults   to
30              /etc/GeoIP.conf.
31

USAGE

33       Typically you should run geoipupdate weekly. One way to achieve this is
34       to  use  cron.  Below is a sample crontab file that runs geoipupdate on
35       each Wednesday at noon:
36
37              # top of crontab
38
39              MAILTO=your@email.com
40
41              0 12 * * 3 BIN_DIR/geoipupdate
42
43              # end of crontab
44
45       To use with a proxy server, update your GeoIP.conf file as specified in
46       the GeoIP.conf man page or set the http_proxy environment variable.
47

RETURN CODES

49       geoipupdate returns 0 on success and 1 on error.
50

FILES

52       /etc/GeoIP.conf
53              Configuration  file  for GeoIP Update. See the GeoIP.conf(5) man
54              page for more information.
55

AUTHOR

57       Written by T.J. Mather and Boris Zentner.
58

REPORTING BUGS

60       Report bugs to <support@maxmind.com>.
61

COPYRIGHT

63       Copyright (C) 2013 MaxMind, Inc.
64
65       This is free software; see the LICENSE  file  for  copying  conditions.
66       There  is  NO  WARRANTY, express or implied, including, but not limited
67       to, NO IMPLIED WARRANTY of MERCHANTABILITY or FITNESS FOR A  PARTICULAR
68       PURPOSE.
69

MORE INFORMATION

71       Visit  <https://www.maxmind.com/en/geolocation_landing>  to  learn more
72       about the GeoIP2 and GeoIP Legacy databases or to sign up  for  a  sub‐
73       scription.
74