Operation-System Specific-Considerations



If your current operating system is Windows it is recommend to either get a Linux-like environment (e.g. extend the console with Cywing) or better get Wubi (Windows Ubuntu Installer) as a dual boot system. The latter one is very straightforward.

In order to set up a local development version of Denigma on Windows do the following steps:

  1. Install your Developer version of Denigma

    First we get GIT, the cat []. For instance from here []. The installation will ask to choose:

    a) use Git Bash only
    b) run Git from windows command prompt
    c) run Git and included Unix tools from windows command prompt

    Select c).

    Then open the command prompt, navigate to a folder where the Project shall live and run the following command:

    git clone
  2. Preparing Denigma Programming Environment

    i) Installing Python:

    Install Python at first if you haven not yet []. We are going with latest version of Python 2 (i.e. 2.7.3), as Python 3 is not yet well established. Many libraries are still in stage 2. So with Python 3 you would have a much smaller application ecosystem.

    If you are on a 64bit machine install the following executable [] under preferentially C:\Python27\.

    ii) Set Environment Variables:

    Next step is to set the environment variables. For this follow: Start > Control Panel > Double click on System Icon System Properties. There under system variables edit PATH and include in the front the following string: C:\Python27\;C:\Python27\Scripts\.

    iii) Install PyCharm:

    Then install a Interactive Development Environment for Python and Django [].

  3. Configuring Virtual Environment:

    Download the latest easy Installer for Windows that fits the installed Python version (e.g. the exe at the bottom of []) and install it.

    If you are on a 64bit machine consider to download, copy it to C:\Python27, navigate into this folder in the DOS prompt and install it by running python [].

    Open a new DOS prompt and run easy_install pip as well as pip install virtualenv.

    Finally, navigate to the Denigma Project folder and create a virtual environment:

    virtualenv env --system-site packages
    python env --system-site packages # only if virtualenv installation failed
  4. Starting Denigma:

    Now its time to prepare Denigma for running. First install some prerequisites:

    Then install all the other required libraries:

    pip install -r denigma/requirements/project.txt
    python syncdb --all
    python migrate --fake
    python runserver

    Open localhost:8000 in the browser and it is accomplished.

  5. Modify Denigma:

    i) modify locally

    git add modified_file 
    git commit -m "Describe the change here"

    ii) upload you modification to the online Denigma

    git push
  6. Keep Denigma updated

    Regularly pull any Changes in Denigma source code:

    git pull


More on Wubi »


If you are on Mac OX this is fine as it is UNIX-based system also the instructions will be majorly for Linux. o

More on Unix »



Linux is the most preferred system in which Denigma and the interaction with it can run. Denigma itself is currently in an Ubuntu environment implemented.

In order to set up Denigma locally just do the following (Ubuntu or at least a UNIX environment is recommended):

  1. Git in:

    Go to the GIT bootcamp (sign up if you haven't already):

    In brief on UNIX:

    $ sudo su # Get full control about your machine.
    $ apt-get install git # Get (g)it!

    Configure Git with your name and e-mail:

    $ git config --global "FULL NAME"
    $ git config --global
  2. Fork Denigma:

    $ git clone
  3. Get the Might to Create Virtual Environments:

    $ curl | python
    $ easy_install virtualenv
    $ cd denigma
    $ virtualenv env
    $ . env/bin/activate
  4. Prepare Environment:

    $ apt-get update
    $ apt-get install python-dev libmysqlclient-dev     # Latter is an optional database-backend
    $ apt-get install -y subversion
    $ pip install -r denigma/requirements/pre.txt       # Prerequisite
    $ pip install -r denigma/requirements/project.txt
  5. Start Denigma:

    $ ./ syncdb --all
    $ ./ migrate --fake
    $ ./ runserver
  6. Change Denigma:

    $ git commit -am "Brief description of the change."
    $ git push origin master
  7. Keep Denigma Updated:

    $ git checkout master # Update to the latest version.
    $ git pull # Pull it from master.


More on Ubuntu »