Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

90 lines (52 sloc) 3.205 kb

Installing Bedrock


It's a simple Playdoh instance, which is a Django project.

These instructions assume you have git and pip installed. If you don't have pip install, you can install it with easy_install pip.

Start by getting the source:

$ git clone --recursive git://
$ cd bedrock

(Make sure you use --recursive)

You need to create a virtual environment for Python libraries. Skip the first instruction if you already have virtualenv installed:

$ pip install virtualenv                     # installs virtualenv, skip if already have it
$ virtualenv venv                            # create a virtual env in the folder `venv`
$ source venv/bin/activate                   # activate the virtual env
$ pip install -r requirements/compiled.txt   # installs compiled dependencies

If you are on OSX and some of the compiled dependencies fails to compile, try explicitly setting the arch flags and try again:

$ export ARCHFLAGS="-arch i386 -arch x86_64"
$ pip install -r requirements/compiled.txt

Now configure the application to run locally by creating your local settings file:

$ cp settings/ settings/

You shouldn't need customize anything in there yet.

Check out the latest product-details:

$ ./ update_product_details

Lastly, you need to install node and the less package. Soon you won't need this for local development but currently it compiles the LESS CSS code on the server-side:

$ npm -g install less

You don't have to use npm to install less; feel free to install it however you want.

Add the path to the LESS compiler in you config file in the settings folder. It is most likely /usr/local/bin/lessc, so add the following line:

LESS_BIN = '/usr/local/bin/lessc'

Make it run

To make the server run, make sure you are inside a virtualenv, and then run the server:

$ ./ runserver

If you are not inside a virtualenv, you can activate it by doing:

$ source venv/bin/activate

If you get the error "NoneType is not iterable", you didn't check out the latest product-details. See the above section for that.


If you want to install localizations, just check out the locale directory:

git svn clone locale
# or
svn checkout locale

You can use git or svn to checkout the repo. Make sure that it is named locale. If you already have it checked out as locales, just do:

ln -s locales locale

You can read more details about how to localize content :ref:`here<l10n>`.


A shortcut for activating virtual envs in zsh is . venv/bin/activate. The dot is the same as source.

There's a project called virtualenvwrapper that provides a better interface for managing/activating virtual envs, so you can use that if you want.

Jump to Line
Something went wrong with that request. Please try again.