Home

Awesome

Build Status codecov

Hearth

HEARTH (noun): the floor of a 'FHIR'place. A fast FHIR-compliant server focused on longitudinal data stores.

This project aims to provide a fast and lightweight FHIR server that also supports some of the FHIR-based IHE profiles. It is still in the early stages of development, follow the project to stay informed.

We do our best to update this project when we have projects with funding that are using it. Any contributions are welcomed and encouraged! Help us make this something great.

Documentation

For more information regarding the capabilities of Hearth and how to get working with it please refer to the wiki documentation

Usage

Using docker compose

Note: Requires docker and docker-compose to be installed

Download the docker compose file from here, then execute to following in the directory you downloaded it to:

docker-compose up

Once started the fhir endpoint will be available on your system at this url: http://localhost:3447/fhir/

For development

To run in development mode use the following commands. First Mongo needs to be available on your system. The easiest way to do this is through docker:

Note: Requires mongo 3.6+

docker run --name hearth-mongo -d -p 27017:27017 mongo

Install dependencies

yarn

Now start the server in dev mode (which uses a dev namespaced database)

yarn dev:start

otherwise for production just run:

yarn start

The default FHIR version is STU3 as set in the config files (we don't yet support R4), to change this either change the config files or make use of overriding config variable via environment variables:

server__fhirVersion=dstu2 yarn start

To run the tests:

yarn test

View the possible config fields here.

Pro dev tips: