Skip to content

DAC Climate and Health

Build a local DHIS2 + CHAP environment, run an evaluation and prediction, then inspect and extend the workflow. The core path has a single choice that does not change the rest: use released CHAP images for the quickest setup, or build CHAP from source. The modeller track (step 8, building your own model) needs the source setup.

Follow the workshop

  •  1. Prepare your machine

    Install Docker, Git, and the small command-line tools used in the exercises.

    Prepare

  •  2. Docker basics

    A quick primer: build and run one container, then a two-service stack with Compose.

    Learn the basics

  •  3. Start DHIS2

    Run the Laos climate demo database and confirm that you can log in.

    Start DHIS2

  •  4. Connect CHAP

    Choose the bundled or source setup and verify the DHIS2 route to CHAP.

    Connect CHAP

  •  5. Install the apps

    Add the Climate App and Modelling App from the DHIS2 App Hub.

    Install apps

  •  6. Evaluate and predict

    Run one shared Laos demo scenario in the app or through the API.

    Evaluate

  •  7. Configure a model

    Create an EWARS variant and run it with the same workflow.

    Configure

  •  8. Build a model

    Scaffold your own CHAP model with chapkit and register it. Needs the source setup.

    Build

Each step starts with its prerequisites and ends with a link to the next step. Assignment boxes mark the checks that should pass before you move on.

Jump to a task

I need to... Go to
Complete the workshop with the fewest setup steps Quick CHAP setup
Build or change chap-core locally CHAP development setup
Run a model by clicking through the app Evaluate and predict in the UI
Script a model run Evaluate and predict through the API
Understand a failed or slow job Find and diagnose failures
Inspect what a run stored Inspect the databases
Protect data before a change Back up and restore
Upgrade CHAP or roll it back Upgrade or roll back CHAP

What you are building

Piece Role Where you use it
DHIS2 Health information platform with the Laos climate demo data. http://localhost:8080
CHAP Modelling engine that evaluates models and produces forecasts. Through the DHIS2 chap route
Modelling App DHIS2 interface for configuring and running CHAP models. Inside DHIS2 
flowchart LR
    Browser["Browser or curl"] --> DHIS2["DHIS2 (:8080)"]
    DHIS2 -- "route: chap" --> CHAP["chap-core (:8000)"]
    CHAP --> Worker["worker + models"]

The Modelling App and API exercises use the same route, model, data mapping, periods, and organisation units. Those shared values live in one place: Workflow and demo data.