DHIS2 Android Settings Web App version 2.2.0 is released

We are pleased to inform you that the version (2.2.0) of the Android Settings web application has been released.

The web app features are intended to support admins in various functions of a DHIS2 Android Capture app implementation. These include configuring synchronization parameters for the DHIS2 Android Capture app, encrypting the local database of the Android devices, customizing the appearance of programs, data sets, and home screen, and adding TEI, program, and dataset analytics items, among other features.

This version has mainly added the following features:

  • Search TEIs before creating is now optional: As in web, searching before entering a new TEI was mandatory to avoid possible duplicates. However, we also heard about other use cases from the community where searching first was not required. In order to accomodate both options, we have made the search optional. The default behaviour is ‘search before adding’, but now you can mark the checkbox in the field “Allow the user to create a TEI without searching” to make the search optional. This setting is program specific, so you can have some tracker programs where the search is optional while is mandatory in others.

  • Use the new tracker importer when syncing TEIs: This is only available from version 2.38 DHIS2 API onwards. The new tracker importer (NTI) is more maintainable and yields a bigger potential for performance enhancements. However, we only recommend to use the NTI in Android for testing environments. Although the NTI has been widely tested and it covers the most common use cases for syncing TEIs, there might be some corner cases that we didn’t have the chance to test. The default sync mechanism is the legacy importer which has been used during the last 5 years. In any case, please let us know if you use the NTI and if you find any issues while syncing TEIs.

You have more info about the new features and fixes in the following link

This web app is compatible with 2.38, 2.37, 2.36, 2.35, and 2.34. We recommend to always use the latest patch versions.

If you plan to use this web app, the following considerations should be taken:

  • The use of this app will overwrite the local settings of all Android devices using the DHIS2 Android Capture app for a given DHIS2 instance.
  • Only users with ‘ALL’ authority are able to use this app to configure the parameters for synchronization, encryption, etc. Other users having access to this app will be able to see the configuration but will not be able to edit any values.
  • If you select the encryption checkbox, it will affect the local database of all Android devices synchronizing with the server for a given DHIS2 instance.
  • This version is compatible with the previous versions (2.0.X and 2.1.X), which means that the settings stored from those versions will apply.


Release Information Link
Download app from the App Hub https://apps.dhis2.org/
Documentation Android Settings Web App doc

Please report any issues you find in jira (Component: [App] Android Settings app)


I am happy to see that the DHIS2 Android Settings Web App version 2.2.0 has been released. The new version does not have many changes, but there are some important fixes and improvements related to the app’s performance.


Thanks for notifying me.
I receive the updates.
I’m working on it.

1 Like