VirtualEnv InstallationΒΆ


Installing Mozillians might be daunting. Ask for help in #commtools on Ping giorgos, he will be happy to help.

You ‘ll need python, virtualenv and pip.

  1. Get a copy of mozillians:

    $ git clone --recursive git:// mozillians
    $ cd mozillians
  2. Create your python virtual environment:

    $ virtualenv --no-site-packages venv
  3. Activate your python virtual environment:

    $ source venv/bin/activate
  4. Install development and compiled requirements:

    (venv)$ pip install -r requirements/compiled.txt -r requirements/dev.txt


    When you activate your python virtual environment ‘venv’ (virtual environment’s root directory name) will be prepended to your PS1.


    Since you are using a virtual environment all the python packages you will install while the environment is active, will be available only within this environment. Your system’s python libraries will remain intact.

  5. Configure your local mozillians installation:

    (venv)$ cp settings/ settings/


    The provided configuration uses a sqlite database with the filename mozillians.db and assumes that server listens to You can alter the configuration to fit your own needs.

  6. Download and run elastic search:

    (venv)$ wget -O /tmp/es.tar.gz
    (venv)$ tar xvf /tmp/es.tar.gz -C venv/
    (venv)$ ./venv/elasticsearch-0.19.4/bin/elasticsearch -p venv/ >/dev/null 2>&1
  7. Update product details:

    (venv)$ ./ update_product_details -f
  8. Sync DB:

    (venv)$ ./ syncdb --noinput && ./ migrate
  9. Create user:

    1. Run server:

      ./ runserver
    2. Load and sign in with BrowserID, then create your profile.

    3. Run:


      to vouch your account and convert it to superuser.

  10. Develop!

    Now you can start contributing to Mozillians. Check out the Mozillians Git-Fu. When you are done this your coding session, do not forget to kill the elastic search process:

    (venv)$ kill `cat venv/`

    and deactivate your virtual python environment by running:

    (venv)$ deactivate

    Next time, before starting you will need to start elasticsearch server again:

    $ ./venv/elasticsearch-0.19.4/bin/elasticsearch -p venv/ >/dev/null 2>&1

    and activate your environment by typing:

    $ source venv/bin/activate

    Have fun!