> ## Documentation Index
> Fetch the complete documentation index at: https://phidatainc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# AgentOS Connection Issues

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

## Browser Compatibility

### 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

* **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](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

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

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 autoPlay muted controls className="w-full aspect-video" src="https://mintcdn.com/phidatainc/jtsD0i7fP8sdy5Nf/videos/agentos-brave-issue.mp4?fit=max&auto=format&n=jtsD0i7fP8sdy5Nf&q=85&s=1aea0a6e46d22a52680461ef2d9472db" data-path="videos/agentos-brave-issue.mp4" />

### 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:

<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

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

```bash theme={null}
ngrok http <your-local-port>
```

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

##### 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 theme={null}
cloudflared tunnel --url http://localhost:<your-local-port>
```

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