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

# FAQ

> Answers to common questions about BrowserWire.

<AccordionGroup>
  <Accordion title="What are the system requirements?">
    BrowserWire requires **Node.js 22+** and runs on **macOS or Linux**. Chromium is installed automatically by Playwright during `npm install`.
  </Accordion>

  <Accordion title="Does BrowserWire upload my data?">
    Yes — recordings (DOM events and interactions) are uploaded to BrowserWire's cloud for AI training. However, the execution server (`bw run`) runs entirely on your machine. API calls are served locally through a real browser instance.

    See the [Privacy](/reference/privacy) page for full details.
  </Accordion>

  <Accordion title="What's the difference between views and actions?">
    **Views** read structured data from a page — product lists, user profiles, order summaries. They're exposed as `GET` endpoints.

    **Actions** perform interactions — clicking buttons, filling forms, submitting data. They're exposed as `POST` endpoints and can accept input parameters.
  </Accordion>

  <Accordion title="Can I use BrowserWire with any website?">
    Yes. BrowserWire works with any website you can open in a browser. The quality of the generated API depends on how thoroughly you interact with the site during recording — the more pages you visit and features you use, the more views and actions the AI discovers.
  </Accordion>

  <Accordion title="How do I update the manifest for a site?">
    Record the same site again with `bw record`. Each recording triggers a new training run that replaces the previous manifest. You can focus on flows you missed in earlier recordings.
  </Accordion>

  <Accordion title="How long does training take?">
    Training typically takes 1–2 minutes. You can monitor progress on the [dashboard](https://app.browserwire.io/dashboard) — look for the training status badge next to your recording.
  </Accordion>

  <Accordion title="The server says 'Not logged in'. What do I do?">
    Run `bw login` to authenticate, then try `bw run` again. Your session token may have expired (tokens are valid for 30 days).

    For CI environments, set the `BW_TOKEN` environment variable instead.
  </Accordion>

  <Accordion title="I'm getting 429 errors from bw run.">
    The execution server limits concurrent requests (default: 3). Each request opens a browser page, so too many parallel requests exhaust the pool.

    Increase the limit:

    ```bash theme={null}
    bw run --max-concurrent 5
    ```
  </Accordion>

  <Accordion title="Can I run bw run in headless mode?">
    Yes:

    ```bash theme={null}
    bw run --headless
    ```

    This runs the Playwright browser without a visible window. Useful for servers or CI environments.
  </Accordion>

  <Accordion title="Port 8787 is already in use.">
    Use a different port:

    ```bash theme={null}
    bw run --port 3000
    ```
  </Accordion>

  <Accordion title="Is BrowserWire free?">
    BrowserWire is currently in **Early Access** and everything is free. You'll be notified before any pricing changes.
  </Accordion>
</AccordionGroup>