A JSON REST api for the db-ip.com geoip database
Latest commit d55e557 Sep 24, 2015 @albix albix Fix minor typo
Failed to load latest commit information.
src/main adds readme and travisci Sep 24, 2015
.gitignore Initial commit Sep 23, 2015
.travis.yml adds readme and travisci Sep 24, 2015
LICENSE Initial commit Sep 23, 2015
README.md Fix minor typo Sep 24, 2015
pom.xml arrg Sep 24, 2015


db-ip JSON REST api


This project leverages a simple Java webapp that acts as a wrapper around the db-ip.com geoip databases. The database is available at different levels of details (depends on how much you spend). The basic databases are available for free. Compared to other geoip services we considered the db-ip.com geoip databases very accurate and complete.

Use this project

Drop the war into you favorite servlet container (like Tomcat). The REST interface is straightforward, just put the ip to query data for in the path:

$ curl -i http://localhost:8080/dbip-api/
HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Content-Type: application/json;charset=UTF-8

{ "address":"",
  "isp":"OTTO GmbH & Co. KG",
  "organization":"Otto Versand Hamburg GmbH",
  "timezoneOffset":"2" }

To configure the location of the db-ip database, pass along the java system property -Ddbip-path= or configure the JNDI environment key dbip-path.

The response above is a response rendered with the full dp-ip database. Use curl -i http://localhost:8080/dbip-api/ping as availability monitoring endpoint.

ØMQ bindings

The project offers ØMQ bindings as well. By default, ØMQ binds to tcp://*:19000. You can configure the binding by passing the java system property -Dzmq-binding or configuring the JNDI environment key zmq-binding.

Building the project

This should install the current version into your local repository

$ mvn clean verify

Releasing the project to maven central

Define new versions

$ export NEXT_VERSION=<version>

Then execute the release chain

$ mvn org.codehaus.mojo:versions-maven-plugin:2.0:set -DgenerateBackupPoms=false -DnewVersion=$NEXT_VERSION
$ git commit -a -m "pushes to release version $NEXT_VERSION"
$ mvn -P release

Then, increment to next development version:

$ git tag -a v$NEXT_VERSION -m "`curl -s http://whatthecommit.com/index.txt`"
$ mvn org.codehaus.mojo:versions-maven-plugin:2.0:set -DgenerateBackupPoms=false -DnewVersion=$NEXT_DEVELOPMENT_VERSION
$ git commit -a -m "pushes to development version $NEXT_DEVELOPMENT_VERSION"
$ git push origin tag v$NEXT_VERSION && git push origin


We're looking forward to your comments, issues and pull requests!


This project is licensed under the Apache License, Version 2.