Public Repository

Last pushed: 6 months ago
Short Description
The HAPI FHIR JPA server is used as as a FHIR server in Consent2Share.
Full Description

Supported Source Code Tags and Current Dockerfile Link


Current Dockerfile

For more information about this image, the source code, and its history, please see the GitHub repository.

What is the HAPI FHIR JPA Server?

The HAPI FHIR JPA server is used as a FHIR server in Consent2Share V3. Consent2Share V3 publishes FHIR patient resource and FHIR consent resource to HAPI FHIR JPA server. This HAIPI FHIR JPA server provides HL7 FHIR DSTU3 models and provides a complete RESTful server implementation with MySQL as datasource.

For more information and related downloads for Consent2Share, please visit Consent2Share.

How to use this image

Start a HAPI FHIR JPA server instance

Be sure to familiarize yourself with the repository's file before starting the instance.

docker run --name hapi-fhir-jpaserver -d bhits/hapi-fhir-jpaserver <additional program arguments>

NOTE: In order for this API to fully function as a microservice in the Consent2Share application, it is required to setup the dependency microservices and the support level infrastructure. Please refer to the Consent2Share Deployment Guide in the corresponding Consent2Share release (see Consent2Share Releases Page) for instructions to setup the Consent2Share infrastructure.


When you start the hapi-fhir-jpaserver image, you can edit the configuration of the instance by passing one or more environment variables on the command line.

database properties

This HAPI FHIR JPA server is using MySQL as data source with default database configuration. To overwrite default database configuration, pass environment variable CATALINA_OPTS=-Djdbc.url=<url>.

docker run --name hapi-fhir-jpaserver -e "CATALINA_OPTS=-Djdbc.url=jdbc:mysql://hapi-fhir-jpaserver-db:3306/hapifhir" --link hapi-fhir-jpaserver-db:hapi-fhir-jpaserver-db -d bhits/hapi-fhir-jpaserver:<tag>

In a docker-compose.yml, this can be provided as follows:

version: '2'
      image: bhits/hapi-fhir
        CATALINA_OPTS: -Djdbc.url=jdbc:mysql://hapi-fhir-db:3306/hapifhir -Djdbc.password=strongpassword
        - "8080:8080"
      restart: always

      image: mysql:5.7
        MYSQL_ROOT_PASSWORD: strongpassword
        MYSQL_DATABASE: hapifhir
      restart: always

Supported Docker versions

This image is officially supported on Docker version 1.13.0.

Support for older versions (down to 1.6) is provided on a best-effort basis.

Please see the Docker installation documentation for details on how to upgrade your Docker daemon.


View license information for the software contained in this image.

User Feedback


Documentation for this image is stored in the bhits/hapi-fhir GitHub repository. Be sure to familiarize yourself with the repository's file before attempting a pull request.


If you have any problems with or questions about this image, please contact us through a GitHub issue.

Docker Pull Command