dotbase/fhir-server repository overview

⁠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
   

   Copy
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
   

   Copy
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"
   

   Copy
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
   

   Copy
2. Start a database container:

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

   Copy
3. Start the development server

   mvn jetty:run
   

   Copy
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.