Installing DHIS2 Live on Mac (Mojave)


When I run DHIS2 live and the browser starts, I get a 503 error, Service Not Available.

I’m pretty good with computers but not an expert at this type of thing. I read the documentation as well as viewed some YouTube videos but can’t get it to work. This is what I’ve done:

  • Installed PostgreSQL
  • Created a db called dhis2
  • Made the owner of dhis2 db a user called dhis
  • Changed the .conf file (screenshot attached)
  • 37%20PM

Not sure what I’m missing, any help would be appreciated.


1 Like

Hi there,
Just 503 is not very informative. I assume you typed the following in a terminal:
java -jar dhis2-live.jar
What error messages did you get in the terminal window?

I assume you added the full dhis.conf file as outlined here:

Also, did you generate the Postgis extension as mentioned in that link?

1 Like

Hi Knut,

Thanks for your response. Here is what I got in the terminal window–no errors that I could see:

And from the browser:

I used the link you gave me and performed those actions. Still no luck.

Thanks for your help.


1 Like

There is clearly an error message in that terminal window, but you will have to scroll up. The last sentence only says that the Jetty server started, but the DHIS2 app has encountered some problem (e.g. wrong password). Is postgresql running on port 5432?

1 Like

With the help of a friend we discovered that the version of Java was the issue. Apparently Java 8 is required. I was running Java 10 before, and then uninstalled it and installed Java 8 and it works now.

Again, thank you for your response and help.

1 Like

Glad to know that you are sorted @andyw.