Cascade input
Pull from another dispergo node only when an LL-HLS or WHEP viewer needs a stream that is absent locally.
This module requires an offline full license. See licensing for configuration and validity.
input.srt.cascade
Pull a missing stream from another dispergo node when the first LL-HLS or WHEP request arrives. Use one fixed staticEndpoint or a Redis-backed registry, never both.
Set output.root for cascade's internal media storage. It remains required for WHEP-only operation and when public cascade LL-HLS is disabled. See shared storage.
"cascade": {
"enabled": true,
"staticEndpoint": "upstream.internal:6002",
"passphrase": "${CASCADE_PASSPHRASE}",
"viewerIdleTimeout": "1m",
"maxOnDemandStreams": 64
}The LL-HLS and WHEP routers are local-first. output.http.llhls.cascadePublicEnabled: false can hide cascade LL-HLS playback while preserving the internal owner used by WHEP. If the requested stream already exists from push or managed pull, it is served locally and no cascade connection starts. A race that creates the local stream during cascade admission gets one automatic local retry.
A usable upstream dispergo anchor appears as cascade in stream detail, regardless of whether the upstream mapping was source-derived or server-fallback. PDT calculation, cascade wire format, and degradation behavior remain unchanged. See wall-clock provenance.
A registry-backed cascade input and output.srt.cascade.registry may run in the same process only with distinct keyPrefix values.
Configuration reference
Use the shared input settings with this module. The complete field reference covers every accepted option; the maximal composition shows how modules fit together.