Configure your endpoint
Once you have one or more relay URLs, configure your endpoint to use them: Your endpoint authenticates to your relays using (optionally) an API key. The iroh-services preset mints a short-lived access token scoped to your endpoint’s key and to relay use only, then configures the endpoint to use your relays.RelayMode::Custom; see Dedicated Infrastructure.
Why use your own relay?
Running dedicated relays gives you:- Isolation: your traffic isn’t mixed with other applications
- Performance: relays close to your users reduce latency and improve NAT traversal success
- Capacity: the shared public infrastructure is rate-limited
- Redundancy: distribute relays across regions or cloud providers for failover
- Compliance: keep relayed traffic inside your own network or jurisdiction
Get a relay
You have two paths. Pick managed if you want a relay running today. But you’re never locked in! You can always self-host later if you want.Deploy a managed relay
Sign up for Iroh Services and spin up a managed relay for your project in minutes.
Self-host a relay
Run the
iroh-relay binary on a server with a public IP and DNS name. Automatic TLS via ACME is built in.