Cascade input
Pull from another dispergo node only when an LL-HLS or WHEP viewer needs a stream that is absent locally.
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.
"cascade": {
"enabled": true,
"staticEndpoint": "upstream.internal:6002",
"passphrase": "${CASCADE_PASSPHRASE}",
"viewerIdleTimeout": "1m",
"maxOnDemandStreams": 64
}The LL-HLS and WHEP routers are local-first. 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.