Linux Installation Guide

This guide assumes that you have already installed Ruby and rails. To get instructions on how to do that go through the installations project here

Set up Postgres

Skip this if you have already installed and setup a user for postgresql.

If you're running Ubuntu, postgresql packages are aready in the apt repositories:

$ sudo apt-get update
$ sudo apt-get install postgresql postgresql-contrib libpq-dev

If not, you'll need to add the postgres repo to your sources and install:

$ sudo sh -c "echo 'deb http://apt.postgresql.org/pub/repos/apt/ precise-pgdg main' > /etc/apt/sources.list.d/pgdg.list"
$ wget --quiet -O - http://apt.postgresql.org/pub/repos/apt/ACCC4CF8.asc | sudo apt-key add -
$ sudo apt-get update
$ sudo apt-get install postgresql-common
$ sudo apt-get install postgresql-9.3 libpq-dev

Make sure the postgres server is running

sudo systemctl start postgresql

# additionally, to enable postgres at system startup
sudo systemctl enable postgresql

Next we need to create our role. Run the following:

$ sudo -u postgres createuser yourusername -s
$ sudo -i -u postgres psql

# Check that the user was created with:
postgres=# \du
# If you want to add a password to the role you created, run:
postgres=# \password yourusername
# Type \q to quit

If you encounter an error, could not connect to server or PG::ConnectionBad, try to start the PG server again:

$ sudo systemctl restart postgresql

With PostgreSQL installed, continue on with the Running TOP Locally instructions