Skip to main content

Health Management Information System (HMIS) Package


The Instant OpenHIE architecture, codebase, and documentation are under active development and are subject to change. While we encourage adoption and extension of the Instant OpenHIE framework, we do not consider this ready for production use at this stage.

The Instant OpenHIE HMIS Package is an indepedent architectural base that other packages can build off of.

This package has two parts to it:

Package functionality#

This package sets up containers that support the DHIS2. The DHIS2 instance is completely blank with default user access. DHIS2 is accessible on port 8081.

The configuration of DHIS2 is completely up to the implementer. An example of a custom package that has configured DHIS2 for its usecase is the WHO Covid19 surveillance package.

DHIS2 does not appear to be easily "un-configured" therefore perfect your configuration strategy locally before trying to configure your live environments.

Deployment strategy#

DHIS2 was already dockerised so we were able to re-use those images for our work in the core package.

We supplied a Docker Compose file for the setup and configuration of this application.

  1. Main docker-compose.yml file - sets up the base applications

For Kubernetes, we created deployment and service resource files for each component of each application. The setup is orchestrated by a kustomization.yml file for easy deployment.

HMIS Package Dev guide#

For testing purposes, this package can be run independently. Below are some notes of how to do this. The recommended way to run Instant OpenHIE is described here.

Select a deployment target below and follow the getting started steps in setting up this package.

Before proceeding, ensure that you are in the root Instant OpenHIE directory.

From the working directory, execute the follow:

yarn docker:instant init -t docker hmis

This will create all the services and print out their logs in the terminal.

View running Docker resources#

Execute the below commands to see the running Docker containers and the state that they are in.

To display all containers:

docker ps -a

To stop the containers, use the command:

yarn docker:instant down -t docker hmis

To completely remove all project components, use the following option:

yarn docker:instant destroy -t docker hmis