Connect Your AgentOS

Connect a local or deployed AgentOS runtime to monitor and manage its agents, teams, and workflows from the AgentOS Control Plane.

Before You Connect

Runtime	Requirements
Local	AgentOS running on your machine and reachable from your browser, usually at `http://localhost:7777` or `http://localhost:8000`
Live	AgentOS available at a browser-reachable HTTPS URL with Security & Auth configured for production traffic

Live AgentOS connections require a paid plan.

Connect the Runtime

Open the Control Plane

Open os.agno.com, sign in, and click CONNECT OS.

Enter the connection details

Choose Local or Live, then complete the form:

Field	Value
Environment	Local for a runtime on your machine. Live for a browser-reachable HTTPS endpoint.
Endpoint URL	The AgentOS base URL, such as `http://localhost:7777`. Do not include `/docs` or another route.
Name	The label shown in the runtime selector, such as `Development`.
Tags	Optional labels such as `dev`, `stg`, or `prd`.

Connect the runtime

Click CONNECT. For Control Plane-managed JWT authorization, enable Token-Based Authorization (JWT) before connecting. The Control Plane creates a signing key pair and shows the public verification key.

Configure Control Plane-managed JWT authorization

If you enabled Token-Based Authorization (JWT), copy the generated public key into JWT_VERIFICATION_KEY, run AgentOS with authorization=True, then restart or redeploy the runtime.

export JWT_VERIFICATION_KEY="your-public-key"

The Control Plane keeps the matching private signing key and uses it to issue scoped tokens. See the Authorization quickstart for the complete runtime configuration.Keep your existing credential setup when the runtime already uses OS_SECURITY_KEY or self-managed JWTs. See Security & Auth for the available authentication paths.

Verify the connection

Select the runtime again after it restarts.

Check	Expected
Connection	A green indicator appears beside the runtime name.
Components	Registered agents, teams, and workflows appear on Home.
Test run	Select a component in Chat and start a new session.

If your browser blocks a local connection, allow local-network access for os.agno.com. See AgentOS Connection Issues for browser-specific steps.

Next Steps

Task	Guide
Run a component and inspect its session	AgentOS Control Plane
Configure authentication and permissions	Security & Auth
Call the runtime from an application	Using the AgentOS API

Get Started

AgentOS

Example Usage

Connect Your AgentOS

Before You Connect

Connect the Runtime

Next Steps

​Before You Connect

​Connect the Runtime

​Next Steps

Before You Connect

Connect the Runtime

Next Steps