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

# Firefox

[Mozilla Firefox](https://www.mozilla.org/firefox/) is a free, open-source web browser for Windows, macOS, and Linux with proxy support built directly into its settings.

Follow the step-by-step guide below to configure the following Oxylabs proxies with Firefox:

* [**Residential & Mobile Proxies**](#residential-and-mobile-proxies)
* [**Datacenter Proxies**](#datacenter-proxies)
* [**Dedicated Datacenter Proxies (Enterprise)**](#dedicated-datacenter-proxies-enterprise)
* [**Dedicated Datacenter Proxies (Self-service)**](#dedicated-datacenter-proxies-self-service)
* [**ISP Proxies**](#isp-proxies)
* [**Dedicated ISP Proxies**](#dedicated-isp-proxies)

{% hint style="info" %}
**Note:** Firefox applies proxy settings to the entire browser profile, and its native settings screen has no fields for a proxy username and password – Firefox asks for those in a separate dialog the first time it connects. 

If you need several proxy configurations side by side, or one-click switching between them, use the [Oxy® Proxy Extension](/integrations/proxy-integrations/oxy-proxy-extension-for-chrome.md) for Firefox or [FoxyProxy](/integrations/proxy-integrations/foxyproxy.md) instead.
{% endhint %}

{% stepper %}
{% step %}

### Open Firefox settings

Open the **☰ menu** in the top-right corner and select **Settings**.

<img src="/files/vYXAwBw2BP0S6a6Nd34J" alt="" height="372" width="624">
{% endstep %}

{% step %}

### Go to Advanced settings

Select the **Privacy and security** tab and scroll down to the **Connection and software security** section, and click on A**dvanced settings**.

<img src="/files/zDNIrXWtamFxE9ZT7cfO" alt="" height="372" width="624">
{% endstep %}

{% step %}

### Open proxy settings

Click on the **Configure proxy** option in the **Proxy settings**.

<img src="/files/EsmnVlJ4F0p79XUQoLo5" alt="" height="288" width="597">
{% endstep %}

{% step %}

### Manual proxy configuration

Click on the **Manual proxy configuration** to set up your own proxy connection, and check the **Also use this proxy for HTTPS option**.

![](/files/VogkAdKL7Q7yPq060ALH)
{% endstep %}

{% step %}

### Add proxy details

Fill in either **HTTP proxy** or **SOCKS host** (Make sure SOCKS v5 is selected) and its correlated Port for your chosen proxy type:

* [Residential & Mobile Proxies](#residential-and-mobile-proxies)
* [Datacenter Proxies](#datacenter-proxies)
* [Dedicated Datacenter Proxies (Enterprise)](#dedicated-datacenter-proxies-enterprise)
* [Dedicated Datacenter Proxies (Self-service)](#dedicated-datacenter-proxies-self-service)
* [ISP Proxies](#isp-proxies)
* [Dedicated ISP Proxies](#dedicated-isp-proxies)

#### Residential & Mobile Proxies

**Proxy type:** `HTTP`, `HTTPS`, or `SOCKS5`

**Host:** `pr.oxylabs.io`

**Port:** `7777`

![](/files/nMZSJDzHYnIKbQWL5ETn)

You may also use **additional parameters** with Residential and Mobile proxies to set the geo-location (country, state, city, and etc.) and control sessions. Check out the [Residential Proxies documentation](/products/proxies/residential-proxies.md) to learn more. The table below provides an overview of available parameters and their example values.

<table><thead><tr><th width="147.5">Proxy parameter</th><th width="412">Example</th><th width="129.5">Protocols</th></tr></thead><tbody><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/UPg2AOzHh8eTwZf0ZfxE#country-specific-entry-nodes">Country entry node</a></td><td><p><strong>Host:</strong> <code>//us-pr.oxylabs.io</code></p><p><strong>Port:</strong> <code>10000</code></p></td><td>HTTP, HTTPS</td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/UPg2AOzHh8eTwZf0ZfxE">Country</a></td><td><strong>User:</strong> <code>customer-username-cc-US</code></td><td>HTTP, HTTPS, SOCKS5</td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/e93RpcKghZnkSC6ATFPI">State</a></td><td><strong>User:</strong> <code>customer-username-st-US_texas</code></td><td>HTTP, HTTPS, SOCKS5</td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/SFkPGxvpqV8rBtKfCMo8">City</a></td><td><strong>User:</strong> <code>customer-username-city-paris</code></td><td>HTTP, HTTPS, SOCKS5</td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/GZqlA7kjGCjYeRz47eX0">Continent</a></td><td><strong>User:</strong> <code>customer-username-cn-NA</code></td><td>HTTP, HTTPS, SOCKS5</td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/ReB4Ej6De1X1uPh5QrRB">Postal code</a></td><td><strong>User:</strong> <code>customer-username-cc-US-postalcode-90210</code></td><td>HTTP, HTTPS, SOCKS5</td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/ATRXHGvVOBqV6HM3m3j4">ASN targeting</a></td><td><strong>User:</strong> <code>customer-username-ASN-21928</code></td><td>HTTP, HTTPS, SOCKS5</td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/MARGpYxVNKNfIa0J3Khs">Session</a> (up to 1440 minutes)</td><td><strong>User:</strong> <code>customer-username-sessid-qwerty123-sesstime-30</code></td><td>HTTP, HTTPS, SOCKS5</td></tr><tr><td><a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/MARGpYxVNKNfIa0J3Khs#sticky-proxy-entry-nodes">Sticky session</a></td><td><p><strong>Host:</strong> <code>//us-pr.oxylabs.io</code></p><p><strong>Port:</strong> <code>10001</code></p></td><td>HTTP, HTTPS</td></tr></tbody></table>

{% hint style="info" %}
Firefox saves one proxy login per host and port. When you change your username to switch country, Firefox keeps signing in with the old one – delete the saved login first.

Country entry nodes avoid this. The location sits in the host name, so each one gets its own saved login.
{% endhint %}

#### Datacenter Proxies

**Proxy type:** `HTTP`, `HTTPS`, or `SOCKS5`

**Host:** `dc.oxylabs.io`

**Port:** `8001`

<img src="/files/Wa1rqXUwIcP9wwMa3hqq" alt="" height="316" width="624">

{% tabs %}
{% tab title="Pay-per-IP proxies" %}
The port is the sequential number assigned to an IP address from the [proxy list](/products/proxies/datacenter-proxies/proxy-list.md). Thus, port `8001` uses the first IP address from your list. You may also enable [proxy IP rotation](/products/proxies/datacenter-proxies/ip-control.md) by setting the port to `8000`.

Furthermore, you can specify the [geo-location](/products/proxies/datacenter-proxies/select-country.md), for example, the US, by setting the **Proxy username** to `user-USERNAME-country-US`.
{% endtab %}

{% tab title="Pay-per-traffic proxies" %}
The port `8001` picks a random IP address but stays consistent during a session. Alternatively, you can [rotate proxy IPs](/products/proxies/datacenter-proxies/ip-control.md) with each request by using port `8000`.

If you want to use a specific [geo-location](/products/proxies/datacenter-proxies/select-country.md), for example, the US, set the **Proxy username** to `user-USERNAME-country-US`.
{% endtab %}
{% endtabs %}

#### Dedicated Datacenter Proxies (Enterprise)

**Proxy type:** `HTTP`, `SOCKS5`

**Host:** `1.2.3.4` (IP address from your [proxy list](/products/proxies/dedicated-datacenter-proxies/enterprise/proxy-lists.md))

**Port:** `60000` (HTTP) or `1180` (SOCKS5)

![](/files/YpKEEE5sh1pWVArNWwLW)

For Enterprise Dedicated Datacenter Proxies (purchased via sales), you’ll have to choose an IP address from the acquired [proxy list](/products/proxies/dedicated-datacenter-proxies/enterprise/proxy-lists.md).

#### Dedicated Datacenter Proxies (Self-Service)

**Proxy type:** `HTTP`, `HTTPS`, or `SOCKS5`

**Host:** `ddc.oxylabs.io`

**Port:** `8001`

![](/files/zVvyg3V68O7H1ppU8JU7)

For Self-Service Dedicated Datacenter Proxies (purchased via Oxylabs dashboard), the port indicates the sequential number of an IP address from the acquired [proxy list](/products/proxies/datacenter-proxies/proxy-list.md). If you want to get a different IP with each request, change the **Port** to `8000` to enable [proxy rotation](/products/proxies/dedicated-datacenter-proxies/self-service/proxy-rotation.md).

#### ISP Proxies

**Proxy type:** `HTTP`, `HTTPS`, or `SOCKS5`

**Host:** `isp.oxylabs.io`

**Port:** `8001`

![](/files/bDyTVE1GxFXEk9eLCx9c)

ISP Proxies assign each port to a specific IP address and location. Port `8001` always uses the first IP from your [proxy list](/products/proxies/isp-proxies/proxy-list.md). Use port `8000` to enable [proxy rotation](/products/proxies/isp-proxies/proxy-rotation.md).

To get rotating IPs from a specific country's proxy pool, set the username using this format: `user-USERNAME-country-XX`, where `XX` is the country code (e.g., `US` for United States).

#### Dedicated ISP Proxies

**Proxy type:** `HTTP`, `HTTPS`, or `SOCKS5`

**Host:** `disp.oxylabs.io`

**Port:** `8001`

<img src="/files/kcg6bdxfTHvpPDCn0nfD" alt="" height="316" width="624">

You will need to choose the port assigned to an IP address from the purchased [proxy list](/products/proxies/dedicated-isp-proxies/self-service/proxy-list.md), which you can find on the Oxylabs dashboard. The `8001` port will pick the first IP address from your list for all requests. Use port `8000` for automatic [proxy IP rotation](/products/proxies/dedicated-isp-proxies/self-service/proxy-rotation.md).
{% endstep %}

{% step %}

### Save the settings

Click **OK** to save and close the dialog.
{% endstep %}

{% step %}

### Enter your credentials

Load any website. An Authentication Required dialog appears, naming the proxy you configured. Enter your Oxylabs proxy `username` and `password`, then click **Sign in**:

{% hint style="info" %}
You can create and manage your proxy users in our [**dashboard**](https://dashboard.oxylabs.io/en/)**.**
{% endhint %}

![](/files/a5XH0a2WeBigsy5hHHPH)

| Proxy type                                  | Example                                                                                                                  |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Residential & Mobile proxies                | <p><strong>User Name:</strong> <code>customer-USERNAME</code></p><p><strong>Password:</strong> <code>PASSWORD</code></p> |
| Datacenter proxies                          | <p><strong>User Name:</strong> <code>user-USERNAME</code></p><p><strong>Password:</strong> <code>PASSWORD</code></p>     |
| Dedicated Datacenter proxies (Enterprise)   | <p><strong>User Name:</strong> <code>USERNAME</code></p><p><strong>Password:</strong> <code>PASSWORD</code></p>          |
| Dedicated Datacenter proxies (Self-service) | <p><strong>User Name:</strong> <code>user-USERNAME</code></p><p><strong>Password:</strong> <code>PASSWORD</code></p>     |
| ISP proxies                                 | <p><strong>User Name:</strong> <code>user-USERNAME</code></p><p><strong>Password:</strong> <code>PASSWORD</code></p>     |
| Dedicated ISP proxies                       | <p><strong>User Name:</strong> <code>user-USERNAME</code></p><p><strong>Password:</strong> <code>PASSWORD</code></p>     |

{% hint style="warning" %}
Make sure to add the `customer-` or `user-` prefix to your username if your proxy type requires it.
{% endhint %}
{% endstep %}

{% step %}

### Check your proxy connection

Visit [ip.oxylabs.io/location](https://ip.oxylabs.io/location). The page returns the IP address and location the website sees – confirm it matches the proxy you configured rather than your own connection.

<figure><img src="/files/OCkRQbOvj1ncEHfNvYCE" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

You are now using Firefox with your own configured proxy.

If you’re looking for one-click switching between proxy profiles instead, see our guides for the [Oxy® Proxy Extension](/integrations/proxy-integrations/oxy-proxy-extension-for-chrome.md) and [FoxyProxy](/integrations/proxy-integrations/foxyproxy.md).


---

# 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://developers.oxylabs.io/integrations/proxy-integrations/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.