There are a couple of things that this installation guide assumes:

These are basic instructions for installing a copy of Miro Community for local development and testing. You will need to modify the installation for a production environment - for example, you will need to draw up a requirements file that describes your production environment, and you will need to use your own settings file.

Creating a virtualenv

First up, you’ll want to create and activate a virtual environment somewhere on your computer:

virtualenv testenv
cd testenv
source bin/activate

Installing Miro Community

Run the following commands from the root of your (installed and activated) virtualenv:

pip install -e git+git:// --no-deps
cd src/mirocommunity/test_project
pip install -r requirements.txt
python syncdb # This will prompt you to create an admin user
python runserver

Congratulations! You’re running a local testing instance of Miro Community! You can access it in your web browser by navigating to, and you can get the admin by navigating to

If this is your first time using a Django app, you should definitely check out the Django tutorial to get a better understanding of what’s going on, how to change the project settings, etc. The testing project can be a helpful place to start, but it is not meant to be used in a production setting.


Using the test project unaltered for a production server would be extremely insecure, because its SECRET_KEY is not secret.