# AgentOS Connection Issues (/faq/agentos-connection)



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 [#browser-compatibility]

### Recommended Browsers [#recommended-browsers]

* **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 [#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 [#solutions]

### For Chrome and Edge Users [#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](https://developer.chrome.com/blog/local-network-access) and [Microsoft Edge Local Network Access](https://learn.microsoft.com/en-us/deployedge/ms-edge-local-network-access).

### For Firefox Users [#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](https://support.mozilla.org/en-US/kb/control-personal-device-local-network-permissions-firefox).

### For Brave Users [#for-brave-users]

Allow localhost access for `os.agno.com` when Brave prompts, or update that site's localhost permission in Brave settings. See [Brave's localhost permission guide](https://brave.com/privacy-updates/27-localhost-permission/). If Shields still blocks the connection:

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

<video className="w-full aspect-video" src="/videos/agentos-brave-issue.mp4" />

### For Safari and Other Browsers [#for-safari-and-other-browsers]

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

#### Use a Tunneling Service [#use-a-tunneling-service]

Tunneling services expose your local endpoint to the internet:

<Warning>
  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](/agent-os/security/overview).
</Warning>

##### Using ngrok [#using-ngrok]

1. Install ngrok from [ngrok.com](https://ngrok.com)
2. Run your local server
3. Create a tunnel with ngrok:

```bash
ngrok http <your-local-port>
```

4. Use the provided ngrok URL on [AgentOS](https://os.agno.com).

##### Using Cloudflare Tunnel [#using-cloudflare-tunnel]

<Warning>
  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.
</Warning>

1. Install `cloudflared` from [Cloudflare's setup guide](https://developers.cloudflare.com/tunnel/setup/)
2. Run your local server
3. Create a Quick Tunnel:

```bash
cloudflared tunnel --url http://localhost:<your-local-port>
```

4. Use the provided Cloudflare URL on [AgentOS](https://os.agno.com).