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.
See the API/Javadocs for the DHIS 2 source code.
The slide sets can be used for DHIS 2 training and presentations, and are being used at the DHIS 2 Academies.
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.
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
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.