Skip to main content
Connect your AWS deployment to os.agno.com to monitor and manage your agents.

Prerequisites

Before connecting, ensure:
RequirementCheck
Deployment is runningcurl https://your-domain.com/health returns OK
HTTPS is configuredURL starts with https://
Certificate is validNo browser warnings when visiting your domain
HTTPS is required. If you haven’t set it up yet, see Add HTTPS.

Connect Your AgentOS

1

Open os.agno.com

Go to os.agno.com and sign in.
2

Click Connect OS

Click “Connect OS” and select “Live”.
AgentOS connection dialog
3

Enter your endpoint

Enter your production URL:
https://api.yourdomain.com
4

Verify connection

The instance should show “Connected” status.

Verify Connection

Once connected, you should see:
  • Your agents listed in the dashboard
  • Real-time status updates
  • Ability to interact with your agents

Troubleshooting

StatusCauseSolution
”Unhealthy”Health check failingCheck /health endpoint returns 200
”Unreachable”Network issueVerify HTTPS certificate is valid
”Connection refused”Firewall blockingCheck security group allows inbound 443

Check from os.agno.com’s perspective

Your endpoint must be publicly accessible. Test from outside your network:
curl -I https://api.yourdomain.com/health
Should return HTTP/2 200.

Next Steps