server
Operational listener and API
Configure the separate control listener, health endpoints, metrics and graceful shutdown.
Runtime modules
Configure strict loading, operational control, observability and optional processing around the media modules.
Choose runtime modules
transcode
Compatibility repair
Configure bounded compatibility repair, canonical H.264 normalization or optional HEVC input conversion.
webhook
Outbound webhook events
Configure event delivery and consume stream, recording, LL-HLS readiness and thumbnail payloads.
Container image variants
The unsuffixed Server image is FFmpeg-free. Use the matching -transcode image when compatibility repair, thumbnail generation or WebRTC audio conversion needs FFmpeg. For example, the current first-run image's counterpart is ghcr.io/dispergo/server:v0.8.0-transcode. A compatible custom image can supply another FFmpeg build.
An FFmpeg-capable image does not itself enable a module or change its license requirements. GPU profiles additionally need a compatible encoder build and accelerator runtime that pass startup probes. Probe success does not establish full-size live throughput.
Configuration document
The binary reads dispergo.jsonc, then dispergo.json, beside the executable unless -config selects another path. The container default is /etc/dispergo/dispergo.jsonc.
Unknown or duplicate fields, type errors, invalid durations and trailing data fail startup. JSONC comments are accepted; trailing commas are not.
Every string value supports strict ${NAME} environment interpolation. $$ produces one literal dollar sign. There is no shell expansion, recursion, default syntax or interpolation in object keys.
| Top level | Purpose |
|---|---|
license | Optional offline full-license file. See setup and validity. |
server | Operational listener and shutdown lifecycle. |
input | SRT push, pull and cascade inputs. |
output | HTTP playback, MOQT, recording, thumbnails and SRT outputs with shared services. |
transcode | Optional bounded compatibility repair, canonical H.264 normalization or HEVC input conversion. |
webhook | Optional bounded event delivery. |