Connecting to Relays

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 only) 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

QUIC mandates TLS 1.3 — there is no plaintext mode.

System trust store (default)

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

Accept any certificate

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

Caution

Only use this for development. Never accept arbitrary certificates in production.

Custom CA

Provide a PEM file for relays using a private Certificate Authority. In the CLI, use --ca-cert <PATH>.

Draft version selection

moqtap supports MoQT drafts 07 through 17. Draft-17 is the latest.

• Desktop app — select the draft version in the connection UI
• CLI — use --draft <VER> (e.g., --draft 17); moqtap peek auto-detects the relay’s draft version
• Browser extension — auto-detects the draft from CLIENT_SETUP wire bytes

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

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

# 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

Connecting with the desktop app

1. Enter the relay URL in the connection bar
2. Select the draft version
3. Configure TLS if needed
4. Click Connect

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)