Manual installation

Note: What is described below is a quickstart installation, setting default passwords both for the database and the Django system, etc.

The installation instructions below have been tested on an out-of-the-box installation of Ubuntu Desktop 14.04 (the Desktop rather than the Server version has been used, since the majority of installs are likely to be for testing and developing, where having a full working environment and X-server installed comes in handy.) If you are using a different *nix flavor, you have to find the corresponding installation packages used with apt-get below – the installation steps carried out with pip, however, will be exactly the same.

Attention: When Django’s debugging is switched on (DEBUG=TRUE), there is a memory leak. so, if you are setting up a virtual machine, and want to carry out imports of large files with Django’s debug setting switched on, make sure to give it at least 3GB of memory.

  1. If you are behind a proxy, use the graphical user interface for setting the proxy (System Settings > Network): set the proxy and apply it system-wide.

    Be sure to open a new terminal for the following steps in order to propagate the proxy information also into the terminal’s environment.

  2. Make sure that you have git installed:

    sudo apt-get install git

    If you are behind a proxy, configure to use the proxy:

    git config --global http.proxy $HTTP_PROXY
    git config --global https.proxy $HTTP_PROXY
  3. If you have not already done so during installation of the operating system, create a user mantis:

    sudo useradd mantis

    and log in as this user.

  4. In /home/mantis, create a folder ti:

    mkdir /home/mantis/ti
    cd /home/mantis/ti
  5. Clone the django-mantis repository from github and change to the development branch:

    git clone
    cd django-mantis
    git checkout development
    cd ..
  6. Copy the installation files to top-level of the ti directory:

    cp django-mantis/quickstart_files/install_scripts/* /home/mantis/ti
  7. Install the required packages:

    cd /home/mantis/ti
    sudo bash
  8. Configure postgresql:

    cd /home/mantis/ti
    sudo bash /home/mantis/ti/
  9. Create development environment:

    cd /home/mantis/ti
  10. Start the services (Celery and Django):

    cd /home/mantis/ti

    Now you can log into the system at using the user admin with password admin.

  11. (Optional): Pull some sample data into the system:

    cd /home/mantis/ti

    (Use a different shell or interrupt the server while importing; the celery service will still run in the background and make sure that basic indicators found in the imported data are transfered into the Mantis Actionables application.)