Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


Colima is an alternative to Docker, which has gained popularity due to recent license changes for Docker Desktop. The following page documents the steps needed to run Bahmni using Colima.

Read more about Colima here:

Read more about Docker Desktop license changes here:

TODO: Vijay Anand Shanmughadass / Siva Reddy Pathuri from SNOMED CT team will document these steps soon.

Docker Desktop is licensed:

Docker Desktop is a licensed software. It is licensed under the Docker Subscription Service Agreement. The agreement states that Docker Desktop is free for personal use, education, and non-commercial open source projects. Otherwise, it requires a paid subscription for professional use. Paid subscriptions are also required for government entities.

The following are the requirements for free use of Docker Desktop:

  • Individuals

  • Non-commercial open source developers

  • Students and educators

  • Small businesses of fewer than 250 employees AND less than $10 million in revenue


If you want to use Docker CLI/Engine for free, you can use Colima or Rancher. Both projects are free to use and offer similar functionality.

  • Docker CLI/Engine is the command-line interface for Docker. It is free to use.

  • Colima is an open source project that allows you to run Docker Engine in a virtual machine. It is free to use.

  • Rancher is a commercial project that provides a web-based interface for managing Docker Engine. However, Rancher also offers a free community edition that allows you to use Docker Engine for free.

Installing Colima:

Colima is an open source project that provides a way to run Docker Engine on macOS and Linux without the need for Docker Desktop. It is a lightweight alternative to Docker Desktop that offers similar functionality.

To use Docker Engine with Colima, you will need to install the following:

  • Docker Engine

  • Colima

You can install Docker Engine using the following commands:

  • macOS: brew install docker

  • Linux: apt install docker

You can install Colima using the following commands:

  • macOS: brew install colima

  • Linux: pip install colima

Once you have installed Docker Engine and Colima, you can start using Docker by running the following command:

colima start

This will start a Docker Engine VM in the background. You can then run Docker commands by using the docker command.

Configuring Colima for Bahmni:

Update the CPU settings and Memory settings as follows:

colima start --edit

Code Block
# Number of CPUs to be allocated to the virtual machine.
# Default: 2
cpu: 8

# Size of the memory in GiB to be allocated to the virtual machine.
# Default: 2
memory: 12

Useful References:


Running Bahmni on Docker

Page Tree
rootRunning Bahmni on Docker