How to Install DHIS-2 on Any Windows Computer using the installer

Installing District Health Information System 2 (DHIS2) on any Windows computer is a simple process that will not take more than 10-15 minutes. All you need is a CD with the installer on it or download it from here.

DHIS 2 Live

This package is extremely easy to install and convenient as it contains everything you need in order to run DHIS 2, including GIS, reporting and charting. It is based on an embedded Jetty servlet container and an embedded H2 database. Simply unpack the archive, run the executable file and you are good to go. For production use we recommend that you use PostgreSQL as DBMS. Login on the empty database is admin / district.
Package Size Version
DHIS 2 Live 111 Mb 2.22


WAR file

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 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.

Package Upgrade notes Release notes Size Version
DHIS 2 WAR-file Upgrade notes Release notes 109 Mb 2.22
DHIS 2 WAR-file Upgrade notes Release notes 107 Mb 2.21
DHIS 2 WAR-file Upgrade notes Release notes 97 Mb 2.20
DHIS 2 WAR-file Upgrade notes Release notes 95 Mb 2.19
DHIS 2 WAR-file Upgrade notes Release notes 93 Mb 2.18

Android apps

The Android applications are mobile extensions of DHIS 2 and allows for capture and analysis of your date. The apps are generally linked directly to your DHIS 2 server, removing the need for manual steps for synchronizing data between the clients and the server. Data can be saved while being offline and uploaded to the server when connectivity is present.

Google Play APK Size
Data capture APK 1.6 Mb
Event capture APK 3.8 Mb
Tracker capture APK 3.8 Mb
Dashboard APK 3.2 Mb


Java mobile client

The DHIS 2 mobile clients runs on Java enabled mobile phones. The solution relies on an available data connection also known as GPRS, Edge or 3G, over which it communicates with a DHIS 2 server instance being publicly available on the internet.

There are two separate client applications available: the facility reporter and the program tracker. The facility reporting client is for regular data reporting from a facility, while the program tracker is designed for following up and reporting on individual program service deliveries to beneficiaries, as part of the name-based component of DHIS2.

Package Descriptor Size Version
DHIS 2 Mobile Aggregate Reporter JAR JAD (Descriptor) 240 Kb 2.16
DHIS 2 Mobile Aggregate Reporter JAR JAD (Descriptor) 130 Kb 2.11
DHIS 2 Mobile Program Tracking JAR JAD (Descriptor) 430 Kb 2.16
DHIS 2 Mobile Program Tracking JAR JAD (Descriptor) 376 Kb 2.15

Sample data

When setting up your system it is useful to have access to a database with sample data. This database contains data from the DHIS 2 implementation in Sierra Leone. Note that the H2 database file needs write privileges on any OS. The PostgreSQL file must be unzipped and can be imported through pgAdmin restore function or with psql -d dbname -U username -f demo.sql

Package Size Version
Sample database (PostgreSQL) 118 Mb 2.22
Sample database (PostgreSQL) 118 Mb 2.21
Sample database (PostgreSQL) 103 Mb 2.20
Sample database (PostgreSQL) 103 Mb 2.19
Sample database (PostgreSQL) 87 Mb 2.18


Download various tools used for DHIS 2 maintenance and a sample Drupal skin.

Package Size Version
Logo 45 Kb 1.1
Translation resource editor 69 Kb 1.0
PostgreSQL database backup cron setup 10 Kb
Tracker DHIS 2.14 migration SQL script 1 Kb
MyDatamart 3 Mb 1.2.1 Win
Sqlite odbc driver 3 Mb Windows

Data management and analytics
DHIS 2 lets you manage aggregate data with a flexible data model which has been field-tested for more than 15 years. Everything can be configured through the user interface: You can set up data elements data entry forms, validation rules, indicators and reports in order to create a fully-fledged system for data management. DHIS 2 has advanced features for data visualization, like GIS, charts, pivot tables and dashboards which lets you explore and bring meaning to your data.
Individual data records
DHIS 2 enables you to collect, manage and analyse transactional, case-based data records. It lets you store information about individuals and track these persons over time using a flexible set of identifiers. As an example, you can use DHIS 2 to collect and share essential clinical health data records across multiple health facilities. Individuals can be enrolled for longitudinal programs with several stages. You can configure SMS reminders, track missed appointments, generate visit schedules and much more.
You can expand the reach of DHIS 2 through a wide range of mobile solutions. DHIS 2 lets you register cases, events and personal information, track individuals, conduct surveys and capture aggregate data, all through a mobile phone. DHIS 2 provides a range of mobile solutions based on SMS, plain HTML and Java for feature phones, and a high-end Web-based solution with offline support for smartphones.

Awesome visualization
DHIS 2 lets you explore and understand your data through great visualization features. Get the complete overview through the pivot table feature, spot trends in your data with charting and visualize your geographical data aspects using the GIS functionality.
DHIS 2 analytics is so easy to use that anyone can take advantage of it. The system is based on simple and intuitive principles and enables you to create analysis from live data in seconds. DHIS 2 is completely web-based, making it simple to share your analysis with colleagues.
All your data in one place
DHIS 2 gives you great dashboards which easily lets you place all of your data in a single view. Search and drag charts, maps and pivot tables into your dashboard. Create any number of dashboards and easily switch between them. Include your personal messages and alerts directly. Click on any dashboard item to drill down and explore it further.

Social analytics
DHIS 2 enables people to communicate and share interpretations of data. It lets you define your personal profile, write and share interpretations and comments on charts, maps and reports and create groups of people. DHIS 2 allows you to communicate with other users through the integrated messaging feature, letting you receive feedback, quickly fix issues and communicate news and updates. You can even let people self-register their own account.
On premise or in the cloud
DHIS 2 is open source software and can be installed at your servers and used for free. The installation process is documented here. You can also go for a professionally managed DHIS 2 instance in the cloud. A managed DHIS 2 instance takes care of the backup, security, monitoring and high-speed connectivity aspects of the deployment and allows you to focus on the information system itself.
Open source
DHIS 2 is free and open source software released under the liberal BSD license. It is developed in Java and runs on any platform with a JRE 8 installed. DHIS 2 is web-based and follows HTML 5 standards. You can download the WAR file and drop it into a Web container like Tomcat. Or download the Live package and simply click the executable file.
The DHIS 2 user interface comes fully translated into 8 languages. In addition DHIS 2 lets you translate your database content into as many languages as you like. Each user can easily switch between languages on the fly. If you need to translate the user interface into a new language that's easy, too.
Highly scalable
With DHIS 2 you can have thousands of concurrent users and hundreds of millions of data records using only a single, standard web-server. It lets you analyse and explore your data and get answers within tenths of a second. DHIS 2 is being used as national health information systems in a large number of countries and has thousands of days in production leading up to a high-performing and mature system.
DHIS 2 comes with great capabilities for system interoperability and features its own format for meta-data and data exchange called DXF 2 as well as the ADX standard. Most parts of the system can be accessed through the extensive REST-based Web API, making interoperability with third-party clients like Android apps, Web portals and other information systems easy. You can even set up scheduled integration jobs in order to periodically synchronize with or import data from other sources.

Insert the installer CD in the CD drive

On doing so you would get this window popping up on your screen, press any key (spacebar works fine) and go to next step

    If you do not get the popup window, press and hold the windows key (the key marked with the windows logo on your keyboard) and press "E". This will open up a windows explorer window with four different options. Select the CD option / icon labeled "dhis2" and double click.

    Opening the CD will display three different files, double-click on the one named "installer" (or maybe it will show as "installer.bat"). You should now see the same image as shown in step 2a, press any key (spacebar works fine).

    Now wait until the dos-window says "installation completed successfully". There will be quite a few messages running down your screen, especially in the beginning, ignore these. Once the dos-window looks like the picture below, the installer is done. Press any key to get rid of the window.

    You should now have a new icon called "DHIS2" on your desktop as shown in the following picture. Double-click on the icon.

    First the following window will be displayed on your screen:

    Select «Don't import anything» and click on Next. Then you will get the following screen (if it does not show up right away, please wait a couple of minutes):

    Click on Yes. Then enter the username “admin” and password “district” on the screen, followed by pressing the enter key, and you will get following screen:

    Click Never for This Site.

    Finally you should get following screen:

    DHIS2 is ready for use! The next time you start DHIS2 you will not have to do the above steps, but it will instead be like described in step above.

    Here is how it will look when you now start the DHIS2-icon: Login with the username “admin” and password “district”.
    As you have now installed DHIS2 on your computer, the next time you want to work with DHIS you will not have to use the installation CD and go through the above described process, so you can now remove it from the computer.Next time you restart the machine you will be asked which user to log on as – administrator or dhis2:


    Like This Article ? :

    We encourage healthy criticism, so do not hesitate to leave your thoughts in comment box.