Installation from binary¶

Download¶

geoip-updater binaries are available on releases page.

Choose the archive matching the destination platform:

And extract geoip-updater:

wget -qO- https://github.com/crazy-max/geoip-updaterreleases/download/v1.11.0/geoip-updater_1.11.0_linux_amd64.tar.gz | tar -zxvf - geoip-updater

After getting the binary, it can be tested with ./geoip-updater --help command and moved to a permanent location.

Server configuration¶

Steps below are the recommended server configuration.

Prepare environment¶

Create user to run geoip-updater (ex. geoip-updater)

groupadd geoip-updater
useradd -s /bin/false -d /bin/null -g geoip-updater geoip-updater

Create required directory structure¶

mkdir -p /usr/local/share/geoip
chown geoip-updater:geoip-updater /usr/local/share/geoip

Copy binary to global location¶

cp geoip-updater /usr/local/bin/geoip-updater

Running geoip-updater¶

After the above steps, two options to run geoip-updater:

1. Creating a service file (recommended)¶

See how to create Linux service to start geoip-updater automatically.

2. Running from terminal¶

/usr/local/bin/geoip_updater \
  --edition-ids GeoLite2-City,GeoLite2-Country \
  --license-key 0123456789ABCD \
  --download-path /usr/local/share/geoip \
  --schedule "0 0 * * 0"

Updating to a new version¶

You can update to a new version of geoip-updater by stopping it, replacing the binary at /usr/local/bin/geoip-updater and restarting the instance.

If you have carried out the installation steps as described above, the binary should have the generic name geoip-updater. Do not change this, i.e. to include the version number.

Last update: 2021-09-05 13:56:10
Created: 2020-07-23 13:19:07