Movebase FHIR Server

FHIR Server for the Movebase infrastructure.

Quick Nav

1. Production Deployment
2. Contributing

Production Deployment

Want a FHIR Server that supports profiles established throughout the Movebase project? The easiest way is to deploy our docker stack for that. Just follow the steps below to get started.

❗ This setup is meant for folks that just want to deploy the Movebase FHIR Server including a database. If you want to deploy an instance of the whole Movebase project see the central Movebase repository.

Requirements

• Docker Engine >= v1.13

Deployment

1. Create a docker swarm if you don't already have one:

   docker swarm init
   

2. Start both, a FHIR Server as well as a database container:

   curl https://raw.githubusercontent.com/dot-base/fhir-server/master/docker-compose.yml --output docker-compose.yml
   docker stack deploy -c docker-compose.yml fhir-server
   

3. Set the following environment variables on your production system. We advice auto generating a secure password and choosing a different username than admin ;).

   export FHIR_DB_USER="YOUR_DB_USER"
   export FHIR_DB_PASSWORD="YOUR_DB_PW"

4. Done and dusted 🎉. This will deploy two containers: a Movebase fhir server as well as a postgres database container.
5. [optional] Add these containers to your docker swarm or kubernetes config. Hint: You can use the docker-compose.yml as a template for this.

❗ Per default, port 8080 of the FHIR server container is exposed. You can change that, and other deployment options inside the docker-compose.yml. Remember to redeploy the stack after updating that file.

Contributing

Requirements

• Java JDK >= v11
• Maven >= v3
• Docker Engine >= v1.13
• A local copy of this repository

Running Locally

1. Create a docker swarm if you don't already have one:

   docker swarm init
   

2. Start a database container:

   docker stack deploy -c docker-compose-dev.yml dev-database
   

3. Start the development server

   mvn jetty:run
   

4. By default the server is available at http://localhost:8080.
5. Go and mix up some code 👩‍💻. The server will reload automatically once you save. Remember to keep an eye on the console.