Soumitra Dutta Oxford-What are the steps to set up a CHT instance?

Technical Support
1

Hi, My name is Soumitra Dutta, an Oxford-based entrepreneur & photographer. I’m planning to set up a Community Health Toolkit (CHT) instance and would really appreciate your guidance.

Could anyone share the steps you usually follow to get a CHT instance up and running?

Regards

Soumitra Dutta

2

Hi Soumitra, welcome!

Prerequisites:

  • Docker
  • git

Quickest Way: CHT Docker Helper Script

You can download and run just the helper script directly — no need to clone the whole repo:

  curl -s -o cht-docker-compose.sh https://raw.githubusercontent.com/medic/cht-core/master/scripts/docker-helper/cht-docker-compose.sh            
  chmod +x cht-docker-compose.sh                                                                                                                  
  ./cht-docker-compose.sh

It will automatically download all images, set up TLS, pick an unused port, and give you a running instance with login credentials. Full docs:
App Developer – Community Health Toolkit

For Production

When you’re ready to deploy for real, follow the production hosting guide:
Host CHT with Docker – Community Health Toolkit

After Setup

Once running, you’ll want to look at:

  • Building a CHT App — configuring forms, contacts, tasks
  • cht-conf — the CLI tool for deploying app configuration to your instance

Happy to help if you hit any snags along the way!

1 Like