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

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

The question should be specific, self-contained, and written in natural language.
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.