Android Documentation: Install, Configure and Use

DHIS2 Android apps are constantly evolving, and while the functionality of the Android app has increased over time, the remain some areas where the Android App and DHIS2 core software differ. Reviewing the documentation below, which links to our primary DHIS2 documentation site, will provide a comprehensive picture of what can be done with the DHIS2 Android App, as well as providing guidance and lessons learned from real-world implementations and use cases.

On this page, you can also find useful information about installing the DHIS2 Android Capture App, a short summary of recommendations for mobile deployment, and ways that you can contribute to the app yourself. Finally, this page also includes links to the legacy DHIS2 mobile apps, which have been replaced by the current DHIS2 Capture Android App.

Links to download and install the DHIS2 Capture Android App (and legacy apps) are available on our Install Android App page

Implementation Guidelines

DHIS2 Mobile Implementation Guidelines

DHIS2 Android App Implementation Guidelines              HTML
DHIS2 Android App Mobile Devices Management Guidelines                     HTML
DHIS2 Android App Mobile Devices Specifications              HTML

App Documentation

Android Capture App (English)

Guidelines to configure the DHIS2 Android Capture App HTML
Guidelines to use the DHIS2 Android Settings Web App HTML
Contribute to the App (Report Issues, Suggest Icons, Add Translations...) HTML

Technical requirements

  Minimum Recommended
Android version Android 4.4 (KitKat) Android 5.1 (Lollipop) or better
DHIS2 version DHIS 2.29 DHIS 2.32 / 2.33 / 2.34

Recommendations for a DHIS2 mobile deployment

If you plan to deploy the DHIS2 Android App in the field, we strongly recommend you to read the Mobile Implementation Guidelines published by UiO. They include chapters on technology requirements, security and configuration aspects, and testing and roll out recommendations. Below you will find some key aspects briefly introduced, we recommend reading the extended document.

Mobile device specifications

The Android App is compatible with DHIS2 versions 2.32, 2.33 and 2.34 nd has no breaking changes with 2.29, 2.30 and 2.31. It requires a device that is running Android v4.4 or higher. In this link you will find recommendations for mobile device acquisitions for a DHIS2 Android deployment.

Testing and Piloting

Before deploying the DHIS2 Android App in the field, you should first do a full round of testing of the app in you own configuration. The app has been extensively tested with the demo servers and real implementation servers. We know, however, that every DHIS2 configuration is special in many senses, and might cause inconsistencies that we have not being able to identify. It is strongly advised to carry out a comprehensive testing of the app in your own server before piloting it.

How to migrate to Android Capture App

If you are ready for deploying the new Android App in the field and your users are already using Event Capture or Tracker Capture, you should follow these steps:

  • Sync data of the current app you are using.
  • Download and install the DHIS2 Android App.
  • Login using your credentials and all data will be synced.

Contribute to the App

How to report a bug

First of all, please check the List of already reported bugs.

The list is always updated as you add new bugs and we work on them. You need an active, free DHIS2 Jira account.

When reporting a bug please specify together with your description:

  • DHIS2 version and build revision
  • DHIS2 Android App version
  • Android OS version
  • Device (when possible)

How to suggest Icons to the library

From 2.30, DHIS2 and the new DHIS2 Android App allows you to select icons for programs, datasets and the options of an optionset. DHIS2.30 incorporates 125 icons. We plan to expand the collection of icons on each future version of DHIS2- for that we need your help: we are seeking ideas for new icon - please submit yours using this form.

How to add translations

As in the rest of the DHIS2 platform, you just need to create an account in Transifex ( https://www.transifex.com/signin/?next=/hisp-uio/) and follow these steps: 

  • Join Existing Organization
  • Search for HISP UiO and select the organization (not the projects)
  • Select ANDROID: Capture project
  • Join the team for the selected language

Legacy Apps

Data Capture Android (English)

User Guide HTML
Features Supported [gDoc] HTML
Value Type Supported [gDoc] HTML
Data Entry web vs Android App [gDoc] HTML

Tracker Capture (English)

User Guide HTML
Features Supported [gDoc] HTML
Value Type Supported [gDoc] HTML
Program Rules Supported [gDoc] HTML
Tracker Capture web vs Android App [gDoc] HTML

Event Capture (English)

User Guide HTML
Features Supported [gDoc] HTML
Value Type Supported [gDoc] HTML
Program Rules Supported [gDoc] HTML
Event Capture web vs Android App [gDoc] HTML

Dashboard (English)

Features Supported [gDoc] HTML
Chart Type Supported [gDoc] HTML
Dashboard web vs Android App [gDoc] HTML