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

# Has Agent Crashed?

> How to fix connection issues when the BrowserOS agent is not responding

If you see **"Failed to Fetch"** or **"Unable to connect to BrowserOS agent"**, your agent has been killed.

<Frame>
  <img src="https://mintcdn.com/browseros/SQ44qH9ZJeym2Wd9/troubleshooting/failed-to-fetch-error.png?fit=max&auto=format&n=SQ44qH9ZJeym2Wd9&q=85&s=1984835b14ac286fcfcc74a0159d569a" alt="Failed to fetch error" width="1004" height="188" data-path="troubleshooting/failed-to-fetch-error.png" />
</Frame>

## Windows: Did you allow the BrowserOS Agent?

When BrowserOS starts for the first time on Windows, a popup will ask if you want to allow **BrowserOS Agent** to access the network. Click **Allow** — the agent runs as a separate process alongside the browser and needs this permission to work. If you clicked **Cancel** or missed this prompt, the agent won't be able to connect.

<Frame>
  <img src="https://mintcdn.com/browseros/SQ44qH9ZJeym2Wd9/troubleshooting/windows-installation-allow-browseros-agent.png?fit=max&auto=format&n=SQ44qH9ZJeym2Wd9&q=85&s=f76fa8734fa6f11cd05356ff958984ca" alt="Allow BrowserOS Agent network access prompt" width="1792" height="1167" data-path="troubleshooting/windows-installation-allow-browseros-agent.png" />
</Frame>

To fix this, go to **Windows Security → Allow an app through your network settings**, and make sure **BrowserOS Agent** is enabled.

## Fix It

<Steps>
  <Step title="Go to Settings → MCP Server and click Restart">
    Open **Settings** from the sidebar, scroll to the MCP Server section, and click **Restart**. Wait a couple of minutes.

    <Frame>
      <img src="https://mintcdn.com/browseros/SQ44qH9ZJeym2Wd9/troubleshooting/mcp-server-restart.png?fit=max&auto=format&n=SQ44qH9ZJeym2Wd9&q=85&s=1b972f683d13b5d6fdac9886b4467a92" alt="Click Restart in MCP Server Settings" width="1436" height="1082" data-path="troubleshooting/mcp-server-restart.png" />
    </Frame>
  </Step>

  <Step title="If restart doesn't work, restart the BrowserOS Agent manually">
    <Tabs>
      <Tab title="Windows">
        1. Open **Task Manager** — press `Ctrl + Shift + Esc` or right-click the taskbar and select **Task Manager**.
        2. In the search bar at the top, type **browseros agent**.
        3. Right-click **BrowserOS Agent** and select **End task**.
        4. Reopen **BrowserOS** — the agent will restart automatically.

        <Frame>
          <img src="https://mintcdn.com/browseros/SQ44qH9ZJeym2Wd9/troubleshooting/troubleshoot-search-restart-agent-task-manager.png?fit=max&auto=format&n=SQ44qH9ZJeym2Wd9&q=85&s=b6a22dbebce4e9e855ad666d2a57e273" alt="Search for BrowserOS Agent in Task Manager and restart it" width="1792" height="1167" data-path="troubleshooting/troubleshoot-search-restart-agent-task-manager.png" />
        </Frame>

        <Note>If the agent still doesn't reconnect, end both **BrowserOS** and **BrowserOS Agent** in Task Manager, then reopen the app.</Note>
      </Tab>

      <Tab title="macOS">
        Right-click BrowserOS in the Dock → **Quit**, then reopen the app.
      </Tab>
    </Tabs>
  </Step>
</Steps>

## Still Not Working?

<AccordionGroup>
  <Accordion title="Check if another application is using the port">
    The agent runs on port `9100` by default. If another application is using this port, BrowserOS cannot start the agent.

    <Tabs>
      <Tab title="macOS/Linux">
        Find the process:

        ```bash theme={null}
        lsof -i :9100
        ```

        Kill it (replace `PID` with the process ID from above):

        ```bash theme={null}
        kill -9 PID
        ```
      </Tab>

      <Tab title="Windows">
        Find the process:

        ```powershell theme={null}
        netstat -ano | findstr :9100
        ```

        Kill it (replace `PID` with the process ID from above):

        ```powershell theme={null}
        taskkill /PID PID /F
        ```
      </Tab>
    </Tabs>

    Then restart BrowserOS.
  </Accordion>

  <Accordion title="Check your firewall or antivirus settings">
    Some firewalls may block local connections. Make sure your firewall allows connections to `127.0.0.1:9100`.

    **Windows users:** Antivirus software sometimes triggers a false positive. Try temporarily disabling your antivirus and restarting BrowserOS.
  </Accordion>
</AccordionGroup>

## Get Help

If you're still experiencing issues, reach out:

<CardGroup cols={2}>
  <Card title="Discord" icon="discord" href="https://discord.gg/YKwjt5vuKr">
    Get help from the community
  </Card>

  <Card title="Slack" icon="slack" href="https://dub.sh/browserOS-slack">
    Join our Slack
  </Card>
</CardGroup>
