Skip to content
Open
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
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions src/components/NavigationDocs.jsx
Original file line number Diff line number Diff line change
Expand Up @@ -483,6 +483,7 @@ export const docsNavigation = [
{ title: 'How It Works', href: '/agent-network/how-it-works' },
{ title: 'Quickstart', href: '/agent-network/quickstart' },
{ title: 'Providers', href: '/agent-network/providers' },
{ title: 'Clusters', href: '/agent-network/clusters' },
],
},
{
Expand Down
40 changes: 40 additions & 0 deletions src/pages/agent-network/clusters.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
import { Note } from '@/components/mdx'

export const description =
'Proxy clusters serve the Agent Network endpoint, routing your agents\' traffic to LLM APIs and gateways on infrastructure you run. Add multiple clusters to scale the environment.'

# Clusters

A **cluster** is a set of reverse proxies that serve your [Agent Network endpoint](/agent-network/how-it-works).
Agents point at the endpoint hostname over the WireGuard tunnel; the proxy cluster terminates that
traffic, enforces identity, policies, limits, and guardrails, and forwards each request to the
upstream LLM API or gateway.

Clusters run on **your own infrastructure**, so agent traffic terminates on machines you operate —
giving you control over the data path, geographic placement, and TLS. Add **multiple proxies and clusters** to
scale the environment: spread load across more proxy instances, place them closer to your agents or
upstreams, and keep the endpoint available if one goes down.

<Note>
Agent Network clusters are the same mechanism as Reverse Proxy clusters, scoped to your account
(**account clusters**). See [Bring Your Own Proxy](/manage/reverse-proxy/bring-your-own-proxy) for
the full cluster model.
</Note>

## Manage Clusters

Go to **Agent Network → Configuration → Clusters** to see every cluster serving your account, along
with the number of connected proxies, online status, and the capabilities each proxy reports.

<p>
<img src="/docs-static/img/agent-network/clusters/agent-network-clusters-list.png" alt="Agent Network clusters list under Configuration" className="imagewrapper-big" />
</p>

Use **Setup Self-Hosted Cluster** to register a new one. Enter a domain for the cluster and pick a
**Deployment Method**: run it yourself with Docker, or use one of the **1-click deployments** for
popular cloud providers to stand up a proxy in a few clicks. The wizard then walks you through the
DNS records to add and starting the proxy.

<p>
<img src="/docs-static/img/agent-network/clusters/agent-network-setup-cluster.png" alt="Setup Cluster wizard with domain and deployment method" className="imagewrapper" />
</p>
Loading