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"
   export HAPI_SSO_REALM_ADDRESS: "YOUR_SSO_REALM_ADRESS"

   The following environment variables can be set optionally, depending on your setup:

   export SENTRY_ENVIRONMENT: "YOUR_SENTRY_ENVIRONMENT"
   export SENTRY_DSN: "YOUR_SENTRY_DSN"
   export PROXY_ADDRESS: "YOUR_PROXY_ADDRESS"
   export PROXY_PORT: "YOUR_PROXY_PORT"

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. a) Start a database container and start the development server separately:

    docker stack deploy -c docker-compose-dev-db.yml fhir-db
    mvn jetty:run
   

   b) or start the the full setup with docker

    docker stack deploy -c docker-compose-dev.yml fhir-server-dev
   

3. By default the server is available at http://localhost:8080.

4. By default authentication will be enabled, but can be disabled in hapi.properties or docker-compose-dev.yml.

5. Go and mix up some code 👩‍💻. The server will reload automatically once you save. Remember to keep an eye on the console.

Authentication

If HAPI_AUTHENTICATION_INTERCEPTOR_ENABLED is set to true, you must specify your identity providers realm url, to fetch a public key and requests must include one of the following headers

Authorization - Bearer sometoken...
X-Forwarded-User - username

FHIR® is the registered trademark of HL7. Use of the FHIR trademark does not constitute endorsement of this product by HL7.