This is a docker container for EtherCIS, an open source openEHR server. It supports the latest summer edition, EtherCIS v1.1.1

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/ 
   

6. Find the ip of your Docker environment:

• If you are using Docker toolbox this tends to be 192.168.99.100.
• If you are using a native Docker installation it will be localhost.

7. You can now connect to the RESTful API via {docker-ip}:8080/{rest-query}

Prerequisites: To create a secure cluster you need to pass your SSH public key during deployment

Click the button below to deploy this application on Azure.

1. Go to 'Manage Resources' in your Azure Portal and click on the new resource group you created
2. Fork this repo and edit the docker-compose.env.production.yml file, replace the letters "aethercis" to your username that you set during deployment
3. Click on the containerservice-resource_group_name and select 'Releases'

• Get started via Github
• Authenticate your Github account and select the forked repo from your Github account
• Define the VSTS project name and account name and select 'create'
• Wait for the Continous Deployment pipeline to succeed

4. Visit visualstudio.com and locate the account you created, open the project related to that account
5. Click on the 'Build and Release' button, wait for the build to be successful
6. Select the 'Releases' tab and double click on 'Release-1' - the project will automatically deploy in the Dev environment
7. Select the Deploy button and deploy to the Production environment

• To test whether the deployment was successful you can perform the following REST API call via command line. Don't forget to change the URL to that of your deployment.

  curl -X POST -H "Auth-Token: {{Auth-Token}}" -H "Cache-Control: no-cache" -H "Postman-Token: f4190d7a-12ea-6fdb-5b73-09206aa8639c" -d '' "http://aethercisagents.westus.cloudapp.azure.com:80/rest/v1/session?username=guest&password=guest" 
  

• EtherCIS uses a RESTful API similar to the Ehrscape API.

• The Docker image contains no data upon startup. Data can be imported into the application and Postgres database using the various queries described in the Ehrscape API.

• EtherCIS is still in active development. If you encounter any issues please use the EtherCIS issue tracker.
• For more information please refer to the official EtherCIS documentation.

• The EtherCIS platform is licensed under the Apache License. A copy of the license can be found in the EtherCIS subfolder.
• All other code is licensed under the MIT ©