Skip to main content
Connection failures to a local AgentOS instance are usually caused by browser security restrictions. Browsers can block requests from os.agno.com to localhost or require local-network permission first.

​
Browser Compatibility

  • Chrome & Edge: Prompt for permission before a public site can access a local endpoint
  • Firefox: May prompt for permission before a public site can access localhost or the local network

​
Browsers with Known Issues

  • Safari: May block local connections due to its strict security policies
  • Brave: Blocks local connections by default due to its shield feature

​
Solutions

​
For Chrome and Edge Users

When os.agno.com requests local-network access, select Allow. If you previously denied the request, open the site permissions for os.agno.com, allow local-network access, and reload the page. See Chrome Local Network Access and Microsoft Edge Local Network Access.

​
For Firefox Users

When Firefox requests access to your device or local network, select Allow. To change a previous choice, open Settings > Privacy & Security > Permissions, then update Device apps and services and Local network devices. See Firefox local network permissions.

​
For Brave Users

  1. Click on the Brave shield icon in the address bar
  2. Turn off the shield for the current site
  3. Click Refresh and try connecting again

​
For Safari and Other Browsers

If browser permissions do not resolve the connection, use a tunneling service.

​
Use a Tunneling Service

Tunneling services expose your local endpoint to the internet:
A tunnel gives the public internet a route to your AgentOS endpoint. AgentOS authorization is disabled by default. Enable authentication and authorization before creating a tunnel. See the AgentOS security overview.
Using ngrok
  1. Install ngrok from ngrok.com
  2. Run your local server
  3. Create a tunnel with ngrok:
  1. Use the provided ngrok URL on AgentOS.
Using Cloudflare Tunnel
The command below creates an anonymous Quick Tunnel for connection testing. Quick Tunnels do not support AgentOS SSE streams. Use a named Cloudflare Tunnel for streamed runs.
  1. Install cloudflared from Cloudflare’s setup guide
  2. Run your local server
  3. Create a Quick Tunnel:
  1. Use the provided Cloudflare URL on AgentOS.