MoQ Ingest
Ingest media via Media over QUIC Transport (MoQT), either by subscribing to a relay or accepting direct publisher connections.
Component Configuration
| Option | Description | Required |
|---|---|---|
id |
A unique identifier for the component instance |
✓ |
displayName |
The name shown in the Studio UI of this component |
✓ |
namespace |
MoQT namespace tuple, slash-separated (e.g. 'stage/primary'). Used in client mode to subscribe to a relay; ignored in listener mode (set 'listener.namespacePrefix' instead). (default: "norsk") |
✗ |
url |
Optional: moqts:// or https:// URL of a relay to pull from. Leave empty for listener-only mode. |
✗ |
listener |
Optional: open a QUIC/WebTransport listener to accept direct publisher connections |
✗ |
disableTlsVerify |
Dev only: disable TLS verification on outbound connections (default: false) |
✗ |
initialState |
The ingest state of this component on start-up (default: "enabled") |
✗ |
notes |
Additional notes about this component |
✗ |
Listener
| Option | Description | Required |
|---|---|---|
namespacePrefix |
Namespace prefix tuple, slash-separated (e.g. 'norsk' or 'stage/primary'). Matched segment-by-segment against each incoming publisher's tuple — so 'stage/primary' routes [stage, primary, …] but NOT [stage, primaryextra]. Multiple MoQ ingests on the same listener pool must use distinct prefixes. (default: "norsk/") |
✗ |
quicServerPort |
QUIC listener port for native MoQT publishers |
✗ |
webTransportPort |
WebTransport listener port for browser publishers (must differ from QUIC port) |
✗ |
quicServerCert |
TLS certificate file path (required when a port is set) |
✗ |
quicServerKey |
TLS private key file path (required when a port is set) |
✗ |
allowedNamespaces |
Full publisher namespaces to allow, each slash-separated (e.g. ['norsk/stage/primary']). Leave empty to accept any publisher that matches the prefix. (default: []) |
✗ |
Moq Preview
| Option | Description | Required |
|---|---|---|
quicServerPort |
QUIC listener port for native MoQT subscribers (optional — only needed for non-browser clients) |
✗ |
webTransportPort |
WebTransport listener port for browser MoQ players. Defaults to 4443. Override via GLOBAL_MOQ_PREVIEW_WEBTRANSPORTPORT env var. (default: 4443) |
✗ |
quicServerCert |
TLS certificate file path. If omitted, a self-signed cert is auto-generated (14-day validity, rotated every 10 days). |
✗ |
quicServerKey |
TLS private key file path. If omitted, auto-generated alongside the cert. |
✗ |
serveFingerprint |
Publishes the cert SHA-256 so the moq-js player can trust it via WebTransport's serverCertificateHashes. Defaults on. (default: true) |
✗ |
Tags: moq moqt quic webtransport ingest