Fix browser-blocked connections to a local AgentOS, including local-network permissions, Brave shields, Safari restrictions, and tunneling workarounds.
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.
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.
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.
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.
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.
