Prerequisites

As geoipdns is based upon djbdns, the requirements are quite similar.

Installation

1. Download geoipdns-latest.tar.bz and decompress.

wget http://geoipdns.org/download/geoipdns-latest.tar.bz
tar -xjvf geoipdns-latest.tar.bz
cd geoipdns*

2. Check conf-cc for the compile flags you care about. (the defaults should be fine for most installations)

3. Compile and install the package.

make setup check

4. Add geoipdns and dnslog users to your system if you don't already have a non-privleged user for the service.

adduser geoipdns
adduser dnslog

5. Create a service directory tree for geoipdns:

geoipdns-conf geoipdns dnslog /etc/geoipdns-1.2.3.4 1.2.3.4

where geoipdns and dnslog are the server daemon user and logging user you want to use to run the service, /etc/geoipdns-1.2.3.4 is the directory for the service and 1.2.3.4 is the IP through which the server will listen.

6. Edit your data file as per the documentation. Minimum survival:

touch /etc/geoipdns-1.2.3.4/root/data

7. Compile your data file.

cd /etc/geoipdns-1.2.3.4/root
make

8. Start the service by linking it into /service

ln -s /etc/geoipdns-1.2.3.4 /service

This should cause either daemontools or runit to start the service.

9. Check to make sure everything is running.

ps axf

If things don't seem to be working, make sure daemontools or runit is running and check the geoipdns log:

tail geoipdns-1.2.3.4 /service/geoipdns-1.2.3.4/log/main/current

(Thanks to Pablo for edits.)

Report Successful Installations

We're interested to get an idea of how GeoIPDNS is used. Please fill out the following form and let us know about your installation. We may eventually show averages from this data but will never make specific entries public.

Name: (optional)
Email: (optional)
Company: (optional)
City, Country: eg. "New York, USA"
URL: (optional)
GeoIPDNS Version:
Comments: Let us know what you are using GeoIPDNS for. (optional)