Luke Baker edited this page Nov 30, 2016 · 27 revisions


This code depends on the pairwise-api. You’ll want to install pairwise first before continuing.

  • git
  • ruby 1.9.3
  • rubygems
  • bundler 1.1.5
  • redis 2.4.X (after installation you can simply run redis-server or setup the proper startup scripts that come with redis for your operating system, so that it starts on server restart)

RedHat-based distros (CentOS, Amazon Linux, Scientific Linux, etc.)

sudo yum install -y ruby-devel make gcc gcc-c++ libxml2-devel libxslt-devel libffi-devel GeoIP-devel mysql-devel mysql sqlite-devel ImageMagick

Debian-based distros (Ubuntu, etc.)

sudo apt-get install -y libmysqlclient-dev libxslt1-dev libxml2-dev libgeoip-dev libsqlite3-dev

Download code

git clone git://

Install the necessary gems

bundle install --path vendor/ --binstubs --local

Some gems may require that native extensions be built. These native extensions may require you to install additional libraries. I’ve tried to enumerate them above in the requirements (e.g., GeoIP-devel, mysql-devel, etc.).

Set up the GeoLite City database

Download the file here: (click on “Download the latest GeoLite City Binary Format”)

Decompress the file and put it in

Continue installing for the proper environment

To complete your installation, the instructions will vary depending on which environment you’re setting up. If you’re setting it up to serve more than a single user, you probably want to choose the production environment. Otherwise for development or testing, choose those environments.


The bulk of the configuration can be found in config/config.yml There is a section for each Rails environment (test, development, production, etc.). There you will be able to change the email addresses used within the application, add an Airbrake API key, and some other key configuration that informs the AOI application how to communication and authenticate with the pairwise server.