Skip to content
mlent edited this page Nov 19, 2014 · 7 revisions

Installing Phaidra

Before you begin installing, we make the assumption that:

  • You are running Ubuntu 12.04 or later -- If you're not comfortable troubleshooting the install yourself, stick with 12.04. There is a known issue relating to 14.10, and pip installing distribute.
  • You have already installed git
  • You have already generated and added ssh keys to your account.

First things first, clone the repo.

If you're an authorized contributor

cd /opt
git clone [email protected]:OpenPhilology/phaidra.git

If you want to simply fork the repo

cd /opt
git clone https://github.com/YOUR_USERNAME/phaidra.git
git remote add upstream https://github.com/YOUR_USERNAME/phaidra.git
git fetch upstream

Build the project

The following commands should be run as root, from /opt/phaidra.

sudo apt-get update
sudo apt-get install fabric
fab install

Prompts during Build

You will be prompted during the installation process several times. Basically: Agree with everything, and pay attention to a couple of questions:

  • Password to the Postgres database: We use phaidra for the test installation, but on production, you will want a secure password. Whatever you set here, also needs to be set in phaidra/settings.py.
  • Name your superuser: If you don't already exist in the database, create a username and password for yourself.

Developer Guide

Backend

Frontend

Content Guide

What did you break?

  • Postgres Database
  • Neo4j
  • Django
  • "The server"
  • Git
  • UI
Clone this wiki locally