AgentOS Connection Issues

Fix browser-blocked connections to a local AgentOS: Brave shields, Safari restrictions, and tunneling workarounds.

Connection failures to a local AgentOS instance are usually caused by browser security restrictions, since some browsers block mixed content requests to localhost.

Browser Compatibility

Recommended Browsers

• Chrome & Edge: Work with local connections by default
• Firefox: Generally works with local connections

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 Brave Users

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

For Other Browsers

If you’re using Safari or hitting issues in another browser, use one of these solutions:

1. Use Chrome or Edge

Both support local connections without configuration.

2. Use Tunneling Services

Tunneling services expose your local endpoint to the internet:

Using ngrok

1. Install ngrok from ngrok.com
2. Run your local server
3. Create a tunnel with ngrok:

ngrok http <your-local-port>

4. Use the provided ngrok URL on AgentOS.

Using Cloudflare Tunnel

1. Install Cloudflare Tunnel (cloudflared) from Cloudflare’s website
2. Authenticate with Cloudflare
3. Create a tunnel:

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

4. Use the provided Cloudflare URL on AgentOS.