Running Bahmni on Docker

The following guide helps you in installing Bahmni using Docker. Docker is an open platform for developers and system admins to build, ship, and run distributed applications. Following instructions are mainly targeted for Mac OS X and Linux users. But they should work with any operating system that supports Docker. You will need to first install docker (and docker-compose). If you are new to Docker, then we encourage you to watch this 15-min introduction to Docker: https://www.youtube.com/watch?v=rOTqprHv1YE

Docker installations

You can install Docker from here. Choose the appropriate installers for your host machine and follow the instructions mentioned for the host platform. MacOS: You can get the dmg file for Docker here.

Note: If you are using Docker Desktop for Mac / Docker Desktop for Windows , it is recommended to increase the Memory resource to at-least 8GB. Please find the reference for Mac / Windows.

Once you have Docker installed, ensure that you are running the daemon. If you want to tune and configure docker, please find detailed information here

While it is not mandatory that you have working knowledge of docker (although desirable), at the least you should know the following commands and usages

docker ps -a - shows all containers
docker rm <container id> - remove a given container
docker container COMMAND - different commands like start/stop/prune for container(s)
docker images - lists all images
docker rmi <image id> - remove a given image
docker volume COMMAND - different commands for managing volumes.

A good link: The Ultimate Docker cheatsheet

Docker Compose installations

Note : If you are using Docker Desktop for Mac / Docker Desktop for Windows, then docker-compose comes bundled with docker and you need not follow the below steps. But make sure to disable Experimental Features for docker-compose from your Docker Dashboard preferences. For other operating systems, you can install docker compose from here.

Currently Bahmni has been tested on docker-compose version 1.29.2. If you are using older versions of docker-compose, please upgrade to the latest version. You can check docker compose version by running docker-compose version

Bahmni Docker Setup Process

Briefly, these are the main steps:

Install latest stable versions of docker & docker-compose in your machine (based on your respective OS)
Clone the bahmni-docker repository (Github Link).
Run the docker-compose command after navigating into the cloned repository (e.g: docker-compose --profile openmrs up to start only the EMR/OpenMRS part of the Bahmni suite)
Bahmni should now be running (open browser at URL: http://localhost/bahmni/home). There are a few simple first time setup steps also to be followed. For exact steps and detailed documentation, please see (README.md) Bahmni Github docker here: https://github.com/Bahmni/bahmni-docker . If you run into issues, feel free to ask questions on Bahmni Slack #community channel.

Other Reference Material

To see current status of Bahmni dockerization work, and to contribute in this, please see this page: Bahmni Dockerization Status
ALTERNATIVE: Mekom Solutions has also dockerized Bahmni and deployed it in various Production scenarios. If you wish to check that out, see this Github repo: https://github.com/mekomsolutions/bahmni-docker-compose