20.3. Installation

This manual assumes that you have installed a minimal distribution of ubuntu server 12.04 LTS, 14.04 LTS or 16.04 LTS. By minimal we mean that only the base operating system is installed together with an openssh server. During the installation you should avoid to install ANY other packages The dhis2-tools package will ensure that the required packages are installed as dependencies.

It is recommended as a general guideline that before proceeding any further you should strengthen the security of the system at this point by improving the security of your ssh service and installing a host based firewall like ufw.

Once your base system is properly installed and secured you can proceed to install the dhis2-tools package from the PPA repository at https://launchpad.net/~simjes91/+archive/ubuntu/dhis2-tools. The easiest way to do so is to run the install.sh script available (with the source code of the package) at https://github.com/dhis2/dhis2tools.

The simplified set of steps to get a dhis2 instance up and running from here are:

  1. turn your user (eg bobj) into a dhis2-admin user by running:

    sudo dhis2-create-admin bobj

  2. create an instance named eg dhis with:

    dhis2-instance-create dhis

  3. deploy the latest stable war file with:

    dhis2-deploy-war dhis

  4. setup a basic nginx template with:


    Note that nginx configuration is not done automatically. Though running the command dhis2-nginx will create a simple site configuration file under /etc/nginx/sites-enabled/dhis2. You may need to edit this file to ensure that instance names and port numbers are correct.

  5. start your dhis instance with:

    dhis2-startup dhis

A full description of these commands and others used for managing your instance is included in the command reference section below.