> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect to Control Plane

> Connect your AgentOS to os.agno.com

Connect your AWS deployment to [os.agno.com](https://os.agno.com) to monitor and manage your agents.

## Prerequisites

Before connecting, ensure:

| Requirement           | Check                                            |
| --------------------- | ------------------------------------------------ |
| Deployment is running | `curl https://your-domain.com/health` returns OK |
| HTTPS is configured   | URL starts with `https://`                       |
| Certificate is valid  | No browser warnings when visiting your domain    |

<Note>
  HTTPS is required. If you haven't set it up yet, see [Add
  HTTPS](/deploy/templates/aws/go-live/https).
</Note>

## Connect Your AgentOS

<Steps>
  <Step title="Open os.agno.com">
    Go to [os.agno.com](https://os.agno.com) and sign in.
  </Step>

  <Step title="Click Connect OS">
    Click "Connect OS" and select "Live".

    <Frame>
      <img src="https://mintcdn.com/agno-v2/xe3Um2HwqeJw8aWN/images/agent-os-connection-dialog-live.png?fit=max&auto=format&n=xe3Um2HwqeJw8aWN&q=85&s=c682c8ffeb2c177e2b60deadd0a1aaad" alt="AgentOS connection dialog" width="615" height="738" data-path="images/agent-os-connection-dialog-live.png" />
    </Frame>
  </Step>

  <Step title="Enter your endpoint">
    Enter your production URL: `https://api.yourdomain.com`
  </Step>

  <Step title="Verify connection">
    The instance should show "Connected" status.
  </Step>
</Steps>

## Verify Connection

Once connected, you should see:

* Your agents listed in the dashboard
* Real-time status updates
* Ability to interact with your agents

## Troubleshooting

| Status               | Cause                | Solution                                |
| -------------------- | -------------------- | --------------------------------------- |
| "Unhealthy"          | Health check failing | Check `/health` endpoint returns 200    |
| "Unreachable"        | Network issue        | Verify HTTPS certificate is valid       |
| "Connection refused" | Firewall blocking    | Check security group allows inbound 443 |

### Check from os.agno.com's perspective

Your endpoint must be publicly accessible. Test from outside your network:

```bash theme={null}
curl -I https://api.yourdomain.com/health
```

Should return `HTTP/2 200`.

## Next Steps

<CardGroup cols={2}>
  <Card title="Build Custom Agents" icon="robot" href="/agents/building-agents">
    Create agents with your own tools and prompts.
  </Card>

  <Card title="Add Tools" icon="wrench" href="/tools/overview">
    Slack, GitHub, databases, and 100+ integrations.
  </Card>

  <Card title="Add Knowledge" icon="database" href="/knowledge/overview">
    Load documents, websites, and databases for RAG.
  </Card>

  <Card title="Add Interfaces" icon="comments" href="/deploy/interfaces">
    Deploy to Slack, Discord, WhatsApp, or expose via MCP.
  </Card>
</CardGroup>