Manual InstallationΒΆ

Firstly, open up a command line shell in your new projects directory.

  1. Create a virtual environment

Linux/Mac OSX: pyvenv venv

Windows: c:\Python34\python -m venv myenv

Python 2.7

pyvenv is only included with Python 3.3 onwards. To get virtual environments on Python 2, use the virtualenv package:

pip install virtualenv
virtualenv venv


virtualenvwrapper provides a set of commands which makes working with virtual environments much more pleasant. It also places all your virtual environments in one place.

To install (make sure virtualenv is already installed):

pip install virtualenvwrapper
export WORKON_HOME=~/Envs
source /usr/local/bin/
mkvirtualenv venv


pip install virtualenvwrapper-win
mkvirtualenv venv
  1. Activate the virtual environment

Linux/Mac OSX: source venv/bin/activate

Windows: venv/Scripts/activate.bat

Virtualenvwrapper: workon venv

  1. Install PIP requirements
pip install -r requirements/dev.txt
  1. **Create the database*
By default require PostgreSQL to be installed
createdb my_site
  1. Load the Initial Data The cookiecutter comes with some pages already created for your convenience including the Homepage with a working bx_slider slide show, contact page, events and news/blog pages. To generate these pages run:

psql -d my_site -f ansible/roles/web/files/initial_data.sql

The default Admin username is admin

The default Admin password is admin123

To copy the media directory to project root.

./ copy_media

  1. Install Packages (Foundation, Font-Awesome etc.) using Bower package manager

We use bower for front-end dependency management. To install front dependencies use

bower install

This will install the supported version of Zurb Foundation, Font Awesome and bxSlider as well as their dependencies.

  1. Run the development server

./ runserver

Your site is now accessible at http://localhost:8000, with the admin backend available at http://localhost:8000/admin/.