microsoft/fhir-server

microsoft/fhir-server

Description: A service that implements the FHIR standard

Language: TSQL

License: MIT

Stars: 1358

Forks: 584

Open issues: 160

Created: 2018-08-23T21:11:07Z

Pushed: 2026-06-11T01:25:39Z

Default branch: main

Fork: no

Archived: no

README:

FHIR Server for Azure

A .NET Core implementation of the FHIR standard.

| CI Build & Deployment | Production | |---|---| |  | 

FHIR Server for Azure is an open-source implementation of the emerging HL7 Fast Healthcare Interoperability Resources (FHIR) specification designed for the Microsoft cloud. The FHIR specification defines how clinical health data can be made interoperable across systems, and the FHIR Server for Azure helps facilitate that interoperability in the cloud. The goal of this Microsoft Healthcare project is to enable developers to rapidly deploy a FHIR service.

With data in the FHIR format, the FHIR Server for Azure enables developers to quickly ingest and manage FHIR datasets in the cloud, track and manage data access and normalize data for machine learning workloads. FHIR Server for Azure is optimized for the Azure ecosystem:

• Scripts and ARM templates are available for immediate provisioning in the Microsoft Cloud.
• Scripts are available to map to Azure AAD and enable role-based access control (RBAC).

FHIR Server for Azure is built with logical separation, enabling developers with flexibility to modify how it is implemented, and extend its capabilities as needed. The logic layers of the FHIR server are:

• Hosting Layer – Supports hosting in different environments, with custom configuration of Inversion of Control (IoC) containers.
• RESTful API Layer – The implementation of the APIs defined by the HL7 FHIR specification.
• Core Logic Layer – The implementation of the core FHIR logic.
• Persistence Layer – A pluggable persistence provider enabling the FHIR server to connect to virtually any data persistence utility. FHIR Server for Azure includes a ready-to-use data persistence provider for Azure Cosmos DB (a globally replicated database service that offers rich querying over data).

FHIR Server for Azure empowers developers – saving time when they need to quickly integrate a FHIR server into their own applications or providing them with a foundation on which they can customize their own FHIR service. As an open source project, contributions and feedback from the FHIR developer community will continue to improve this project.

Privacy and security are top priorities and the FHIR Server for Azure has been developed in support of requirements for Protected Health Information (PHI). All the Azure services used in FHIR Server for Azure meet the compliance requirements for Protected Health Information.

This open source project is fully backed by the Microsoft Healthcare team, but we know that this project will only get better with your feedback and contributions. We are leading the development of this code base, and test builds and deployments daily.

There are also two generally available (GA) managed offerings in Azure, Azure API for FHIR, as well as Azure Health Data Services. Azure Health Data Services includes the ability to deploy a FHIR server and a DICOM server in a single workspace. These Platform as a Service (PaaS) FHIR servers are backed by the open source project in this repository and offer a turn key solution to provisioning a compliant, secure FHIR service.

> [!NOTE] > Please note the following upcoming changes: > - FHIR R4B support ends on July 1, 2026. FHIR R4 remains supported. After the scheduled end of support for R4B, if R4B reference is required, previous versions of the repository can be forked. > - CosmosDB provider support ends on September 30, 2026, in alignment with the previously-announced retirement of Azure API for FHIR. SQL DB provider, which corresponds to the Azure Health Data Services FHIR service, remains supported. After the scheduled end of support for CosmosDB provider, if CosmosDB provider reference is required, previous versions of the repository can be forked.

Release Notes

To see what is releasing in the FHIR Server, please refer to the releases section on this project. Starting in November 2020, we have tags on the PRs to better describe what is releasing. We have also released documentation on how to [test the most recent build](docs/Testing-Releases.md).

Documentation

Getting Started

• Quickstart guides to deploy open source using [portal](docs/QuickstartDeployPortal.md), [CLI](docs/QuickstartDeployCLI.md), and [PowerShell](docs/QuickstartDeployPowershell.md).
• [Sql Schema Migration Guide](docs/SchemaMigrationGuide.md): Describes how to upgrade Schema for Sql Server.
• [Register a resource application](docs/Register-Resource-Application.md): Learn how to register a resource application, which is an Azure Active Directory representation of the FHIR server API.
• [Register a client application](docs/Register-Client-Application.md): Learn how to register a client application registration, which is an Azure Active Directory representation of an application that can be used to authenticate on behalf of a user and request access to resource applications.

Core FHIR Capabilities

• Azure Healthcare APIs FHIR documentation: Includes all FHIR service documentation which has many conceptual, how-to guides, and tutorials that can be leveraged in the open-source as well.
• Features: This document…