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 via the quinn library.
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”Configures a custom ServerCertVerifier that accepts everything. Use this for development relays with self-signed certificates. Equivalent to --insecure in curl.
Custom CA
Section titled “Custom CA”Provide a PEM file for relays using a private Certificate Authority.
Draft version selection
Section titled “Draft version selection”Select the MoQT draft version to negotiate. moqtap currently supports:
- draft-14 (
0xff00000e) — default
The version is negotiated during the CLIENT_SETUP / SERVER_SETUP exchange. The relay picks from the client’s offered versions.
Connection lifecycle
Section titled “Connection lifecycle”connecting → setup exchange → active → (goaway) → closing → closedmoqtap tracks and displays the session state at every transition.