Introduction to Firely Server

Exploring Firely Server

Firely Server is a turn-key FHIR Server that you can set up within minutes. You can try out Firely server for free, either using the sandbox environment at or by obtaining an evaluation license after signing up. The sandbox environment is mostly intended for testing and educational purposes, you can explore the sandbox using our Swagger-based web UI. The evaluation license allows you to explore all the functionality of Firely Server during a week. After this period, it is possible to renew your license by contacting us at

Illustration of Firely server

If you are interested in Firely Server for commercial use within your organization, we provide professional licensing in different tiers:

Starter or Premium. For more information and pricing you can also visit the product site.

Quick navigation

Below you will find some links that help you quickly navigate through the documentation if you want to jump-start your implementation:

Adjust Firely Server to your needs

Once you familiarized yourself with Firely Server, you can start exploring the configuration options. The first step in Firely Server configuration is your database choice. Firely Server makes use of a repository database to save resources in, as well as a smaller administration database. You have several options for these two databases: SQLite is configured by default, but for serious use you’d want to configure MongoDB or SQL Server.

Next, you might want to think about the method of deploying Firely Server. Again, you have several options here, either running Firely Server on Docker, deploying Firely Server with kubernetes, hosting Firely Server on Azure or using a reverse proxy.

With the database configuration and the deployment in place, it is time to tweak your configuration. Make sure Firely Server validates all incoming resources by configuring the validation setting. Configure endpoints for FHIR versions that you want to support, either FHIR STU3, FHIR R4, or FHIR R5. Next, configure the processing pipeline to take along the plugins that you would like to use. You also have the option to include custom plugins of your own design.

You can also further configure the administration database that allows you to configure the so-called conformance resources that drive parsing, serialization, validation and terminology. The administration database is pre-filled with conformance resources such as the StructureDefinitions, Searchparameters, CodeSystems and ValueSets that come with the FHIR Specification. Beyond that you can use the administration database to make Firely Server aware of:

Illustration of Firely server
  • Custom profiles, e.g. national or institutional restrictions on the standard FHIR resources.

  • Custom resources: you can even define resources beyond those in FHIR and they are treated as if they were standard FHIR resources.

  • CodeSystem and ValueSet resources for terminology.

  • Custom Searchparameters: have Firely Server index and search resources on properties that are not searchable with the searchparameters from the FHIR Specification itself.

Extend Firely Server’s functionality

With all configuration in place, you may want to extend the functionality of Firely Server by making use of add-ons below:

Learning more

If you would like to get more familiar with Firely Server and the options it offers, Firely offers courses on Firely Server as well as the SDK on which it is based. These courses are tailored to the needs of you and your team. You can pick the timeslot for this training that fits your schedule. In addition to the Firely Server course there is also a wide range of other courses available to get acquainted or more experienced with FHIR and the FHIR tooling provided by Firely. Additional information can be found on Firely’s resource page. Also, don’t forget to take a look at our interesting blogposts.