Ignis

Explorative area for early-stage concepts and implementations for the Spark FHIR Server

This repository exists to test concepts quickly, learn fast, and validate direction before committing to long-term design decisions.

Important

Ignis is an experimental project for early-stage exploration. Thus, the implementations in this repository are not intended for production use.

Getting Started

MongoDB

Start a local MongoDB instance with Docker:

docker run -d --name ignis-mongo -p 127.0.0.1:27017:27017 mongo:8

Then run the API:

cd src/Ignis.Api
dotnet run

The API will be available at https://localhost:5201/fhir and the OpenAPI document at https://localhost:5201/openapi/v1.json.

Local configuration

Copy src/Ignis.Api/appsettings.local.example.json to src/Ignis.Api/appsettings.local.json to apply per-developer overrides. The file is loaded only when the environment is Development and is gitignored.

Aspire (optional for local development)

There is also an Aspire AppHost that starts MongoDB, the API and Web together. Run aspire run to start it, and see the console for a login with the token.

Kubernetes

See the infrastructure guide for testing Ignis on Kubernetes.

Server setup

For self-hosted deployments, see the server setup guide — checklist, API configuration reference, and Web BFF configuration reference.

Production notes

Structured JSON logging

The API logs to the console via Serilog. To emit one compact JSON object per log line (suitable for log aggregators), set:

Serilog__WriteTo__0__Name=Console
Serilog__WriteTo__0__Args__formatter=Serilog.Formatting.Compact.RenderedCompactJsonFormatter, Serilog.Formatting.Compact

These override the default console sink configured in appsettings.json.