Docker environment for EtherCIS, an open source platform compatible with the OpenEHR standard
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 5 commits ahead of alessfg:master.

Docker Environment for EtherCIS

Docker environment for [EtherCIS] (, an open source platform compatible with the openEHR standard.

Forked to test use with current version of EtherCis (as of 23rd December 2016).

How To Use


  1. Install the latest version of [Docker] ( Docker Compose version 2 is required.
  2. Clone the repository.
  3. Open a terminal in the directory where you cloned the repo.
  4. Run docker-compose up.
  5. Once the startup process completes your terminal should display a message saying:
  • INFO - com.ethercis.vehr.Launcher.start(140) | Server listening at:http://{container-ip}:8080/.
  1. Find the ip of your Docker environment:
  • If you are using Docker toolbox this tends to be
  • If you are using a native Docker installation it will be localhost.
  1. You can now connect to the RESTful API via {docker-ip}:8888/{rest-query}.

Data Storage and Persistence

The postgres Docker container stores data internally at /var/lib/postgresql/data. By default, this volume is not mapped to any volume in the host OS. If you destroy the Docker container the data will only be persisted within a hidden volume partition; which will result in new containers not being able to access the database data. This is by design as local volume partitions are dependent on the host OS and thus specifing a particular volume can lead to undesired errors. To map the volume where data is to be persisted follow the [Docker volume instructions] ( and modify the Dockerfile and docker-compose.yml postgres service accordingly.

Setup with OpenEMPI

Most applications will require the usage of both an EMPI and EHR server. This can be done by following these instructions:

  1. Clone this repository and the [Docker OpenEMPI repository] ( into the same directory.
  2. Download the docker-compose gist available [here] ( into the directory root.
  3. Run docker-compose up.

Deployment on IBM Bluemix

Instructions on how to deploy the Docker environment on an IBM Bluemix server can be found in this issue: