Skip to content

Connecting to Relays

Transport modes

Section titled “Transport modes”

moqtap supports two transport modes:

  • WebTransport (HTTPS) — https://relay.example.com/moq
  • Native QUIC — moqt://relay.example.com

Both use QUIC under the hood. The CLI also supports quic:// (QUIC, falling back to WebTransport with a warning unless --strict) and wt:// (WebTransport only) schemes, and will auto-detect the transport when using moqt:// or https://.

The browser extension intercepts WebTransport connections made by the page — no URL configuration needed.

TLS configuration

Section titled “TLS configuration”

QUIC mandates TLS 1.3 — there is no plaintext mode.

System trust store (default)

Section titled “System trust store (default)”

Works for relays with valid certificates (e.g., Cloudflare-hosted relays).

Accept any certificate

Section titled “Accept any certificate”

Use for development relays with self-signed certificates. Equivalent to --insecure / -k in the CLI.

Custom CA

Section titled “Custom CA”

Provide a PEM file for relays using a private Certificate Authority. With moqtap intercept, use --ca-cert <PATH> for the upstream relay.

Draft version selection

Section titled “Draft version selection”

Draft-23 is the latest MoQT draft. The browser extension covers drafts 07 through 23; the CLI covers drafts 07 through 23.

  • CLI — use --draft <VER> (e.g., --draft 20); moqtap peek auto-detects the relay’s draft version
  • Browser extension — auto-detects the draft from the setup message’s wire bytes

The version is negotiated during the setup exchange. The relay picks from the client’s offered versions.

Connection lifecycle

Section titled “Connection lifecycle”
connecting → setup exchange → active → (goaway) → closing → closed

All moqtap tools track and display the session state at every transition.

Connecting with the CLI

Section titled “Connecting with the CLI”
Terminal window
# Auto-detect transport and draft
moqtap peek moqt://relay.example.com


# Force WebTransport
moqtap peek wt://relay.example.com/moq


# Skip TLS verification for dev relays
moqtap peek moqt://localhost:4443 -k

Configuration file

Section titled “Configuration file”

The CLI resolves relay configuration in this order:

  1. Inline URL argument
  2. MOQTAP_RELAY environment variable
  3. .moqtap.toml in the current directory or any parent
  4. ~/.config/moqtap/config.toml (Linux/macOS) or %APPDATA%\moqtap\config.toml (Windows)
.moqtap.toml
relay = "quic://relay.example.com:4443"
insecure = true  # optional: skip TLS verification (dev only)