This is a build environment to build a docker image for OpenMRS based on official Tomcat image.

The docker image is a self-contained Debian with OpenMRS, Tomcat and JDK installed, which will run on every distribution.

The recommended way to get the OpenMRS Docker Image is to pull the prebuilt image from the Docker Hub Registry.

docker pull khalibre/openmrs-reference:latest

To use a specific version, you can pull a versioned tag. You can view the list of available versions in the Docker Hub Registry.

docker pull khalibre/openmrs-reference:[TAG]

If you wish, you can also build the image yourself by cloning the repository, changing to the directory containing the Dockerfile and executing the docker build command. Remember to replace the VERSION path placeholders in the example command below with the correct values.

git clone <https://github.com/khalibre/openmrs-docker.git>
cd VERSION
docker build -t khalibre/openmrs-reference:latest .

##Persisting your application

If you remove the container all your data and configurations will be lost, and the next time you run the image the database will be reinitialized. To avoid this loss of data, you should mount a volume that will persist even after the container is removed.

For persistence you should mount a directory at the /opt/openmrs/data path. If the mounted directory is empty, it will be initialized on the first run.

docker run -v /path/to/openmrs-persistence:/opt/openmrs/data khalibre/openmrs-reference:latest

Alternatively, modify the docker-compose.yml file present in this repository:

services:
  openmrs:
  ...
    volumes:
      - /path/to/openmrs-persistence:/opt/openmrs/data
  ...

The OpenMRS container can create a default admin user and password. You can set the credentials with the following environment variable OMRS_CONFIG_ADMIN_USER_PASSWORD which is defaults to Admin123.

Bellow are OpenMRS specific environment variables that can be used in the container.

Bellow are Tomcat specific environment variables that can be used in the container.

You add more modules or configurations files to OpenMRS home directory by mouting them in the /mnt/openmrs/files directory. Those files will be copied to OpenMRS home directory.

We'd love for you to contribute to this container. You can request new features by creating an issue, or submitting a pull request with your contribution.

You can also file an issue if you need help.