Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
78 lines (53 sloc) 1.6 KB


Geolocation server / service for looking up user locations.


What you will need to get started

Maxmind GeoIP API for C/C++ -

MacOS Homebrew Install

$ brew install geoip

CentOS Install

yum install libpcap libpcap-devel gdbm gdbm-devel
yum install libevent libevent-devel
tar -zxvf GeoIP-1.4.8.tar.gz
cd GeoIP-1.4.8
make install


Update the configuration to use your license

config lives in either /usr/local/etc/GeoIP.conf or /usr/local/Cellar/geoip/1.4.8/etc/GeoIP.conf depending on install.

UserId ####
ProductIds 133
Run the following to pull the latest db from maxmind

Update maxmind ip database

~$ /usr/local/bin/geoipupdate
/usr/local/Cellar/geoip/1.4.8/share/GeoIP/GeoIPCity.dat can't be opened, proceeding to download database
Updating /usr/local/Cellar/geoip/1.4.8/share/GeoIP/GeoIPCity.dat
Updated database

How to set it up on your own server

Clone the repo, update your server.json. Start the server.

git clone git://
npm install
npm dedupe
vim server.json
node server

If the geoip plugin fails to link to the files in CentOS (after build from source), then do this:

export LD_LIBRARY_PATH=/usr/local/lib/

NOTE: vast-maxmind will fail on npm install if you do not have maxmind 1.4.8 installed.