Home/ Docs/Configuration reference

Configuration reference

Every setting on the gateway, where to set it, and which can be cloud-managed

Get started
Platform overview Install the gateway Connect ECG devices Process your first ECG
Gateway
HL7 MLLP setup Configuration reference Offline & sync queue
API
REST API overview Sync ingest API FHIR R4 endpoints New
Cloud
AI interpretation Plans & billing License keys
5 min read

The gateway reads configuration from two sources, in this order:

  1. Local .env on the gateway host — required for boot (cloud URL, license key, drop folder, HMIS bindings).
  2. Cloud overrides — operational settings the OFFIN team or facility admin can change from the cloud UI without touching the gateway box.

The gateway pings the cloud every minute and pulls the latest cloud-managed settings on each ping.

Local-only (must be in .env)

Key Default What it does
CLOUD_API_URL — Where the gateway sends sync requests
LICENSE_KEY — Authenticates to the cloud (see License keys)
DROP_FOLDER /data/drop-folder Filesystem path the watcher monitors
HL7_HOST / HL7_PORT — HMIS MLLP listener — local network only

Cloud-managed (override per tenant from the dashboard)

Key Default What it does
SYNC_INTERVAL_MS 60000 How often to push queued records
RETENTION_DAYS 30 Local SQLite pruning window
LOG_LEVEL info debug / info / warn / error
HMIS_MODE hl7 hl7 / fhir / off
AI_AUTO_RUN false If true, queue every record for AI interpretation

Where to override from the cloud

  • OFFIN ops — /admin/gateway-configs. Cross-tenant view; can set defaults for all tenants and per-tenant overrides.
  • Facility admin — /settings → Gateway tab. Sees only their own tenant's effective values.

A change in the cloud takes effect on the gateway within ~60 seconds (next heartbeat).

Reload

Local .env changes need docker compose restart gateway. Cloud-managed changes are picked up automatically without restart.

Next: Offline & sync queue