Documentation

The user documentation covers the background and purpose of DHIS 2 together with instructions and explanations of how to perform data entry, meta-data set-up, import and export of data, aggregation, reporting and other topics related to the usage of the software. The implementation guide is targeted at implementers and super-users and addresses subjects such as system design, database development, data harmonization, analysis, deployment, human resources needed and integration with other systems. The end user manual is a light-weight version of the user documentation meant for end users such as district records officers and data entry clerks. You might want to go directly to the snapshot version of installation, Web API or Apps section.

All documentation of can be searched from here.

DHIS 2 Latest Build Documentation (English)

Package PDF HTML HTML single page
User Documentation PDF HTML HTML single page
Implementation Guide PDF HTML HTML single page
End user manual PDF HTML HTML single page
Android Apps manual PDF HTML HTML single page
Developer guide PDF HTML HTML single page

DHIS 2.21 Documentation (English)

Package PDF HTML HTML single page
User Documentation PDF HTML HTML single page
Implementation Guide PDF HTML HTML single page
End user manual PDF HTML HTML single page
Android Apps manual PDF HTML HTML single page
Developer guide PDF HTML HTML single page

API/Javadocs

See the API/Javadocs for the DHIS 2 source code.

Presentations

The slide sets can be used for DHIS 2 training and presentations, and are being used at the DHIS 2 Academies.

Installation instructions

Production

The setting up of a secure and stable production environment involves more than just the installation of the DHIS 2 software. There are many considerations to take into account, including network configuration, domain name registration and SSL, and provisioning of on- and off-site backups. The installation guide here offers a tutorial on installing DHIS 2 in a way which can be customized to fit different environments. If you are installing on an Ubuntu server then you can use the dhis2-tools Ubuntu package. You can also go with a hosted cloud-based setup.

Running local

If you are planning to run DHIS 2 on a local machine, for example trying it out on your laptop, you might find the dhis2-live package useful. Please note that this method is not recommended for production. Instructions are provided below:

  • Download the all-in-one package from the download page. It will run on any platform and only requires that you have a recent JRE or JDK installed (at least version 1.6 update 14), as well as a W3C compatible browser like Chrome available. On Windows it is also good to install a PDF reader like Foxit.
  • Unzip the archive to any location.
  • On Windows, click the dhis2-live executable. On Linux, invoke the startup.sh script file.
  • Point your browser to http://localhost:8080 and log in. Initially the user name/password is admin/district.

Contribute to the documentation

Contributing to the documentation is described in detail in the documentation guide. You can check out the source code in Docbook format from GitHub from here.

Translations

The DHIS 2 user interface is translated to a range of languages incuding Chinese, English, French, Portuguese, Russian, Spanish, Tajik and Vietnamese. Efforts for improving the existing translations or adding new languages are much appreciated. There are two approaches to contributing to the translations.