Installation on Ubuntu 18.04 LTS


I have been experimenting with DHIS for a pilot here. We managed to install DHIS2 on 16.04 LTS the recommended OS following the guide here.

Would like to know if Ubuntu 18.04LTS has been tried and tested and would be a good choice, since 18.04 is the latest LTS. Is there a good guide for Ubuntu 18.04 LTS?




Tagging @sohel to advise on this.


You can try the following.


#set up dhis2-tools repositories

sudo add-apt-repository ppa:bobjolliffe/dhis2-tools

sudo apt-get update

#install dhis2-tools

sudo apt-get install dhis2-tools

#install postgres and postgis which is important for DHIS2 newer versions

sudo apt-get install postgresql-10 postgresql-contrib-10 postgresql-10-postgis-2.4

#install java

sudo apt install openjdk-8-jdk

#verify installed version and choose java 8

sudo update-alternatives --config java

#set up dhis2

#shut down dhis

dhis2-shutdown dhis

#edit tomcat settings to enable external proxy i.e if your proxy is on a different machine
#you have to change the setting below - if not, it should be fine

sudo vim /var/lib/dhis2/dhis/conf/server.xml

#change this line

<Connector port=“8080” address=“” protocol=“HTTP/1.1” proxyPort=“443” scheme=“https”


<Connector port=“8080” protocol=“HTTP/1.1” proxyPort=“443” scheme=“https”

#other tips
you might need to set up ssl using letsencrypt
#follow letsencrypt instructions for setting up certificates from the url below


@jomutsani thanks, I have tried with version 18.04 in my local set up, though I am using OS 16.04 in my server environment. Because I always love to stick with production version that community tested stable and in practice.

I had followed the instructions from here,

I found it is still useful and sufficient for set up in 18.04.

@prabha you may test and check with any advance version of your choice in your local set up but for production usage tested, stable community practice version would be good choice.

1 Like

@jomutsani @sohel I confidently confirm that this works very well. i have used the same guide to install on ubuntu 18.04.4

Probably better for users to check the new updated docs in