DHIS2 Installation on Windows Local Server

DHIS2 Installation on Windows Local Server

DHIS2 Installation on Windows Local Server

The WAR file requires you to install a Java servlet container (like Tomcat or Jetty) and a relational database (PostgreSQL, MySQL and H2 are supported), and is recommended for server setups and environments with high volumes of data and traffic. The latest version is maintained with bug-fixes and minor improvements. You can always get the latest stable release at stable.dhis2.org. Check out the installation guide for Ubuntu Linux here. For the bleeding edge build check out the continuous integration server. WAR files are copied from our continuous integration server where you can find revision number and build time. DHIS2 Version upto 2.30 Note: Don’t start the tomcat in this step. Go to: My Computer (Right Click) → Properties → Advanced system settings → Environmental Variables



2.1 Under “System variables”, click on the “New” button and add the following:

Variable Name: DHIS2_HOME
Value: C:\DHIS2


2.2 Add JAVA_OPT as below: Variable Name: JAVA_OPTS Value: -Xms1024m -Xmx2048m -XX:PermSize=256m -XX:MaxPermSize=1024m


2.3 JDK Path Variable: Add the path variable into the system variables: C:\Program Files (x86)\Java\jdk1.8.0_31\bin


  • Step-3: Create Database: Open the Pg-Admin and follow the below steps:
















# Hibernate SQL dialect connection.dialect = org.hibernate.dialect.PostgreSQLDialect # JDBC driver class connection.driver_class = org.postgresql.Driver # Database connection URL connection.url = jdbc:postgresql:dhis2 # Database username connection.username = dhis # Database password connection.password = dhis # Database schema behavior, can be validate, update, create, create-drop connection.schema = update # Encryption password (sensitive) encryption.password = abcd
  • Step-06: Download the latest war file from: https://www.dhis2.org/downloads




  • Step-07: Copy the war file to your tomcat “webapps” folder as below:
C:\Program Files (x86)\Apache Software Foundation\Tomcat 8.0\webapps



  • Step-08: Run “Tomcat8.exe” as below:





  • Step-09: Close the above window and run “Tomcat8w.exe” then click on the “start” button



  • Step-10: Go to the web browser and browse the server: http://localhost:8080/dhis/



Username: admin
Password: district
  • Step-11: You can upload the demo data from the below link:


  • Please Feel free to contact with me:

Mohammad Julhas Sujan DHIS2 Developer Department of Informatics University of Oslo Cell: +8801989-442856 Email: julhaspustcse@gmail.com Skype: julhas08