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 installation, Web API or Apps section.

Documentation Format
DHIS 2 User documentation PDF | HTML | HTML Single page
DHIS 2 User documentation (Spanish) PDF | HTML | HTML Single page
DHIS 2 Implementation guide PDF | HTML | HTML Single page
DHIS 2 Implementation guide (Spanish) PDF | HTML | HTML Single page
DHIS 2 Implementation guide (French) PDF | HTML
DHIS 2 End user manual PDF | HTML | HTML Single page
DHIS 2 End user manual (Spanish) PDF | HTML | HTML Single page
DHIS 2 Android Apps manuals PDF | HTML | HTML Single page
DHIS 2 CCEI User documentation (English) PDF | HTML
DHIS 2 Documentation Guide PDF | HTML
DHIS 2 Documentation Guide (Spanish) PDF | HTML
DHIS 2 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.