Skip to content

tunnet-relay

Self-hosted connectivity relay. Used for mesh NAT traversal.

Commands

bash
# Local plaintext / --dev (HTTP on :3340)
tunnet-relay run --dev

# Production with TLS + control-plane registration
tunnet-relay run \
  --tls-cert /path/to/fullchain.pem \
  --tls-key /path/to/privkey.pem \
  --control-url http://control:8080 \
  --token RELAY_TOKEN \
  --relay-url https://relay.example.com \
  --region us-east

Common options

FlagEnvDescription
--config / -cTUNNET_RELAY_CONFIGiroh-relay-compatible TOML
--http-bindTUNNET_RELAY_HTTP_BINDPlaintext HTTP bind
--https-bindTUNNET_RELAY_HTTPS_BINDHTTPS bind (needs TLS)
--tls-cert / --tls-keyTUNNET_RELAY_TLS_CERT / TUNNET_RELAY_TLS_KEYManual TLS PEMs
--access-tokenIROH_RELAY_ACCESS_TOKENShared client access token
--control-urlTUNNET_CONTROL_URLOptional control plane base URL
--tokenTUNNET_RELAY_TOKENRegistration token for the control plane
--relay-urlTUNNET_RELAY_URLPublic URL advertised to the control plane
--regionTUNNET_RELAY_REGIONRegion label
--dev-Plaintext localhost development mode

See tunnet-relay --help and self-hosting for full details.

Released under the AGPL-3.0 License.