> For the complete documentation index, see [llms.txt](https://docs.helodata.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helodata.com/integrations/browsers/firefox.md).

# Firefox

Firefox has a **built-in per-instance proxy UI** — no extension or OS-level config required.

## Settings UI

1. Menu → **Settings → General → Network Settings → Settings…**
2. Pick **Manual proxy configuration**.
3. Fill in:
   * **HTTP Proxy**: `gate.helodata.io`, Port `7777`
   * Check **Also use this proxy for HTTPS**
   * (Or use **SOCKS Host** with the same host:port; pick SOCKS v5; check **Proxy DNS when using SOCKS v5**)
4. Click **OK**. Firefox will prompt for credentials on the first request:
   * Username: full proxy username (e.g. `helo_s1a2b3c4d5e-type-res-region-us`)
   * Password: your sub-user password
5. Optional: tick **Remember password** to skip the prompt next time.

\[screenshot: Firefox Connection Settings dialog with helodata host filled in]

## ISP variant

For an ISP IP, replace the HTTP Proxy host with your IP, e.g. `198.51.100.42`. The port is still `8000`.

## Use profiles for parallel identities

Firefox supports multiple profiles, each with its own proxy:

```bash
firefox --no-remote --profile ~/.helo-profiles/us
firefox --no-remote --profile ~/.helo-profiles/de
```

Configure each profile's proxy independently from its own **Network Settings**.

## Container tabs (advanced)

Combine with the **Multi-Account Containers** extension and **Container Proxy** extension to assign a different proxy per container — useful for testing geo-localized variants of a site in one window.

## Verify

Navigate to `https://ipv4.icanhazip.com` — the IP shown should be from helodata, not your own.

## Common pitfalls

* **`HTTPS Proxy` checkbox unchecked** — HTTPS sites then bypass the proxy. Always enable it.
* **SOCKS5 without DNS-over-proxy** — the local resolver leaks DNS and geo targeting breaks. Always tick **Proxy DNS when using SOCKS v5**.
* **Saved password becomes stale after rotation** — re-enter when you rotate sub-user password.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.helodata.com/integrations/browsers/firefox.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.