Skip to content

Latest commit

 

History

History
86 lines (64 loc) · 3.98 KB

README.md

File metadata and controls

86 lines (64 loc) · 3.98 KB
Raw

Movebase FHIR Server

FHIR Server for the Movebase infrastructure.

GitHub release (latest by date) GitHub Workflow Status

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.

Docker Build Status

Requirements

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

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.