Installation from binary¶

Download¶

geoip-updater binaries are available on the releases page.

Choose the archive matching the destination platform:

Then extract geoip-updater:

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

After downloading the binary, test it with ./geoip-updater --help and move it to a permanent location.

Server configuration¶

The steps below describe the recommended server configuration.

Prepare environment¶

Create a user to run geoip-updater, for example 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 steps above, there are two ways to run geoip-updater:

1. Creating a service file (recommended)¶

See 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¶

To update geoip-updater, stop it, replace the binary at /usr/local/bin/geoip-updater, and restart the service or process.

If you followed the installation steps above, the binary should keep the generic name geoip-updater. Do not rename it to include the version number.