Hosting the CHT on self run infrastructure
NoteFor production CHT deployments, Linux is recommended, with Ubuntu the most commonly used. For CHT development, Linux or macOS may be used. Windows can be used for either, but without recommendation.
NoteThese requirements apply to both 3.x and 4.x CHT hosting
Hosting a CHT instance in a cloud provider like AWS or on bare-metal requires you have sufficient hardware specifications, Docker and Docker Compose installed and other infrastructure requirements met.
- 4 GiB RAM
- 2 CPU/vCPU
- 8 GB Hard Disk (SSD prefered)
- SSL certificates ( To be able to use the CHT app on mobile)
- Root Access
Depending on the scale of your operation these may need to be adjusted. Be sure to monitor disk usage so that the 8 GB can be increased as needed.
docker-compose to run the two
NoteSkip this step if you’re following the EC2 guide 3.x as
docker-composeare automatically installed when following the setup scripts.
Docker Desktop for Windows needs either Hyper-V support or Windows Subsystem for Linux 2 (WSL 2). Docker’s Windows Docker Desktop install page covers both scenarios.
docker-compose installed correctly by showing their versions with
sudo docker-compose --version and
sudo docker --version. Note, your version may be different:
sudo docker-compose --version docker-compose version 1.27.1, build 509cfb99 sudo docker --version Docker version 19.03.12, build 48a66213fe
Finally, confirm you can run the “hello world” docker container:
sudo docker run hello-world
There are serious implications to consider when deploying a CHT instance beyond the above requirements. Be sure to account for:
- Alerting - How will alerts be sent in the case of downtime or degraded service?
- Power failures and unplanned restarts - Will the server cleanly restart such that the CHT resumes service correctly?
- Backups - What happens to the CHT data if there’s a hard drive failure?
- Disaster Recovery - What happens if there is a flood at the facility and on-site active and backup data are destroyed?
- Scale - What happens when the hardware deployed needs to be upgraded to increase capacity?
- Updates - By definition TLS certificates expire and software needs to be updated - how will the deployment get these updates on a regular basis?
- Security - While the TLS certificate will protect data on the LAN, is the server hard drive encrypted in the event of property theft?
- Privacy - The CHT inherently carries sensitive patient medical information in the database. Are there sufficient measures in place to protect this sensitive data?
Hosting the CHT on Amazon EC2
Download and run the publicly available Docker image for CHT applications
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.