Skip to main content

Documentation Index

Fetch the complete documentation index at: https://agno-v2-fix-deploy-docs-restructure.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Run through this checklist to confirm your deployment is working correctly.

​
Health Check

Test that your API is responding: 
curl http://YOUR_DOMAIN/health
Expected response: 
{"status": "ok", "instantiated_at": "2024-..."}
Your AgentOS API is running.

​
Connect to Control Plane

  1. Go to os.agno.com
  2. Click Connect OS
  3. Select Local (for Docker) or Live (for Railway/AWS)
  4. Enter your domain or http://localhost:8000
You can see your agents in the AgentOS UI.

​
Test an Agent

Send a test message to any agent:
  1. Select an agent in the sidebar
  2. Type a message and send
  3. Confirm you get a response
Your agents are responding to messages.

​
Interface Verification

If you connected an interface (Slack, Discord, etc.):
InterfaceHow to Test
SlackDM your bot or @mention it in a channel
DiscordSend a message in a channel the bot monitors
TelegramSend a message to your bot
WhatsAppSend a message to your WhatsApp Business number
Your interface is receiving and responding to messages.

​
Troubleshooting

  • Verify the container is running: docker ps or check your cloud dashboard
  • Check the port mapping matches your request
  • For cloud deployments, verify the load balancer is healthy
  • Local: Use http://localhost:8000, not https
  • Cloud: Ensure HTTPS is configured (required for production)
  • Check that your firewall allows inbound traffic on port 8000
  • Check logs: docker compose logs -f or your cloud logging
  • Verify OPENAI_API_KEY is set correctly
  • Confirm the agent is registered in AgentOS(agents=[...])
  • Verify webhook URL is correct in your platform settings
  • Check that event subscriptions are enabled
  • Ensure tokens/secrets are set in environment variables

​
You’re All Set

Your AgentOS deployment is complete. Here’s what to explore next:

Add More Apps

Browse agents, teams, and workflows to extend your deployment.

AgentOS Features

Explore sessions, memory, scheduling, and more.

Build Custom Agents

Create agents tailored to your use case.

Join the Community

Get help and share what you’re building.