> For the complete documentation index, see [llms.txt](https://docs.ipdunar.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ipdunar.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.ipdunar.com`, 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. `ipdunar_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 ipdunar 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 ~/.ipdunar-profiles/us
firefox --no-remote --profile ~/.ipdunar-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 ipdunar, 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
