Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added images/relay-code-snippet.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion iroh-services/relays/managed.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "Managed Hosting"
title: "Dedicated Hosting"
description: "Deploy and configure dedicated relay infrastructure through Iroh Services"
---

Expand Down
51 changes: 51 additions & 0 deletions iroh-services/relays/shared.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
---
title: "Shared Relays"
description: "Multi-tenant relays with authentication, higher rate limits, and predictable performance"
---

import RelayPresetConfig from '/snippets/relay-preset-config.mdx';

Shared relays are multi-tenant relays run by n0.computer on infrastructure that is separate from the [public relays](/iroh-services/relays/public). They sit between the free public relays and fully [managed relays](/iroh-services/relays/managed): you share a box with a small number of other tenants instead of the entire internet.

## Why not the public relays

The public relays are rate-limited based on total traffic across every iroh user on them. When traffic is high or bursty, your application shares those limits with everyone else.

Shared relays:

- Run on separate infrastructure from the public relays, so they aren't affected by bursty traffic or DDoS attacks against them
- Have far fewer tenants per machine
- Have higher rate limits than the public relays
- Optional API key authentication, so only your applications can connect
- Provide more predictable performance

## What you get

For **$19/month**:

- Four relays across the globe
- 10,000 endpoints included, then $0.0003 per endpoint
- Higher rate limits than the public relays, for better performance
- API key authentication, so you can revoke access for endpoints as needed

Metrics are already included with the Pro plan: throughput, direct connection rates, relay usage, and rate limits. See [Metrics](/iroh-services/metrics/index).

## Free trial

You can try shared relays free for 30 days. We won't charge you until the following month, and you can cancel anytime.

## How to get shared relays

Shared relays are in beta, so they're enabled per project on a case-by-case basis. Email [support@iroh.computer](mailto:support@iroh.computer) with your project name and we'll turn them on for you.

## Configure your endpoint

Once shared relays are enabled, go to **Relays → Code Snippet** in your project dashboard to get the configuration for your endpoints.

![Relay code snippet](/images/relay-code-snippet.png)

<RelayPresetConfig />

## Shared vs. Dedicated

Shared relays give you authentication, isolation from public traffic, and higher rate limits at a low fixed price. Choose [dedicated relays](/iroh-services/relays/managed) when you need single-tenant isolation, version locking, blue/green deployments, custom regions, or an uptime SLA.
Loading