← Back to the hackathon home
Topic 18 of 18

Installing Apps From the App Hub

Step by Step Guide: Finding, Installing and Managing Extra DHIS2 Apps

Purpose of this guide

DHIS2 can be extended without writing code. This guide shows the App Hub inside DHIS2, how to install and update an app, how to upload your own, and which apps are worth a look for a malaria programme.

Step 1: What the App Hub Is

DHIS2 ships with the core apps. The App Hub is a catalogue of extra ones, written by the community and by UiO, that install with one click and then appear in the apps menu like any other.

Click: Apps menu → App Management → App Hub
Step 2: Browse and Install
Figure 1. The App Hub inside DHIS2. This picture was drawn for the guide. Your screen will show your own names and dates.
  1. 1Search. By name, or scroll the catalogue.
  2. 2Data quality tools. Outlier checks and consistency reports.
  3. 3Scorecard. Traffic light tables, popular with programmes.
  4. 4Bottleneck analysis. Coverage gaps by district.
  5. 5Newer core apps. Beta versions, such as the aggregate data entry app.
  6. 6INSTALL. One click. The app appears in the menu straight away.
Step 3: Manage What Is Installed
Figure 2. Installed apps. This picture was drawn for the guide. Your screen will show your own names and dates.
  1. 1Installed apps. Everything beyond the core.
  2. 2Version. Check it after a DHIS2 upgrade, since old apps break.
  3. 3Source. From the hub, or uploaded by you.
  4. 4Action. Update or uninstall.
  5. 5Who sees it. Everyone with the right role, so install with care on a production server.
Step 4: Upload Your Own App
Figure 3. A custom app upload. This picture was drawn for the guide. Your screen will show your own names and dates.
  1. 1The drop area. A zip built from a DHIS2 app template.
  2. 2UPLOAD. It then behaves exactly like a hub app.
  3. 3What must be inside. A manifest, so DHIS2 knows the name, icon and entry point.
Before installing anything on a live server: try it on your local DHIS2 from Topic 0 first. An app that writes metadata can make a mess that is slow to undo.
Step 5: Apps Worth Looking At
AppWhat it adds
WHO Data Quality ToolOutliers, consistency and completeness checks in one place
ScorecardTraffic light tables by district, for review meetings
Bottleneck AnalysisCoverage gaps across a cascade
Bulk LoadLoading data from spreadsheets without writing CSV by hand
Line ListingEvent data as a table

Final Checklist

Installing Apps From the App Hub