config.example.yaml

# FHIR Server — example configuration
#
# All keys are optional. Anything omitted falls back to the matching
# environment variable, and then to the built-in default.
#
# Precedence (highest wins): env var > this file > default.
# Point the server at this file with:
#     fhir-server --config /path/to/config.yaml
#   or
#     FHIR_SERVER_CONFIG=/path/to/config.yaml fhir-server

server:
  port: 9090
  baseUrl: http://localhost:9090/fhir/r4
  # HTTP server timeouts — Go duration strings; "0s" disables one entirely.
  # Env equivalents: SERVER_READ_TIMEOUT / SERVER_WRITE_TIMEOUT / SERVER_IDLE_TIMEOUT.
  # NOTE: writeTimeout bounds the WHOLE handler execution — raise it if you ingest
  # large transaction bundles, or slow-but-legitimate requests get cut off after
  # they already committed.
  # readTimeout: 30s
  # writeTimeout: 60s
  # idleTimeout: 120s

logging:
  # One of: debug, info, warn, error
  level: info

database:
  # Either supply a full DSN ...
  url: postgres://fhir:fhir@localhost:5432/fhirdb?sslmode=disable&pool_max_conns=20
  # ... or the individual components (ignored when `url` is set):
  # host: localhost
  # port: "5432"
  # user: fhir
  # password: fhir
  # name: fhirdb
  # Create the server's tables on startup. Off by default because it needs a
  # DB role with DDL privileges — the runtime role usually should not have
  # those. Enable it for a one-off first start, or create tables out-of-band
  # with a privileged role. Env equivalent: FHIR_CREATE_TABLES=true.
  # createTables: false

ig:
  # Implementation guides to load at startup. None are loaded by default —
  # the server runs as a plain base FHIR R4 store until you opt in here.
  # Loading an IG fetches its package from registryUrl on first boot and
  # enables that guide's search parameters and profile validation.
  # Uncomment to load, e.g. US Core:
  packages: []
    # - hl7.fhir.us.core@6.1.0
    # - hl7.fhir.us.carin-bb@2.0.0
  registryUrl: https://packages.fhir.org
  forceReload: false
  cacheDir: .fhir-ig-cache