CHT Local Environment Setup

Setting up a local environment to build and test CHT applications

Purpose of the Tutorial

This tutorial will take you through setting up a local environment to build and test CHT applications. This includes setting up the necessary tools to download and run the CHT public docker image as well as a command line interface tool to manage and build CHT apps.

By the end of the tutorial you should be able to:

  • View the login page to CHT webapp on localhost
  • Upload default settings to localhost

Brief Overview of Key Concepts

CHT Core Framework The Core Framework makes it faster to build full-featured, scalable digital health apps by providing a foundation developers can build on. These apps can support most languages, are offline-first, and work on basic phones (via SMS), smartphones, tablets, and computers.

Medic Project Configurer a.k.a medic-conf is command-line interface tool to manage and configure CHT apps.

Docker is a tool designed to make it easier to create, deploy, and run applications by using containers.

Containers allow a developer to package up an application with all of the parts it needs, such as libraries and other dependencies, and deploy it as one package.

Required Resources

Before you begin, you need to have some useful software and tools that are required for things to work.

First off, install nodejs 8 or later and npm.

You also require Docker for your operating system:

Implementation Steps

Now that you have the dependent tools and software installed, you are ready to set up your CHT local environment.

1. Install medic-conf

Using npm on your terminal or command line, install medic-conf globally using the following command;

npm install -g medic-conf

You can confirm that the installation was successful by typing medic-conf in your terminal or command line.

confirm medic-conf

2. Install the Core Framework

Download the docker-compose.yml file to a folder of your choice. Be sure to place it in a folder that’s easy to find on terminal or command line.

Open your terminal or command line and navigate to the folder where you have your docker-compose.yml file and run the command:

docker-compose up

Once the command is done running, navigate to https://localhost on a Google Chrome browser and login with the default username medic and default password password.

medic login

3. Create and Upload a Blank Project

With medic-conf you can create a blank project. This provides you a template from which you can begin working on CHT. Just run:

mkdir cht-app-tutorials
cd cht-app-tutorials
medic-conf initialise-project-layout

initialise project layout

Then deploy the blank project onto your local test environment with the command:

medic-conf --url=https://medic:password@localhost --accept-self-signed-certs

accept-self-signed-certs tells medic-conf that it’s OK that the server’s certificate isn’t signed properly, which will be the case when using docker locally.

Once you have run the above command it should complete with the message: INFO All actions completed..

all actions completed

Frequently Asked Questions


CHT Core Framework > Guides > Docker Setup

Install tools to download and run the publicly available Docker image for CHT applications

CHT Core Framework > Guides > Windows Development

Notes for developing on Windows