For the complete documentation index, see llms.txt. This page is also available as Markdown.

Firefox

Learn how to integrate Oxylabs proxies in the Firefox browser environment following a step-by-step guide.

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

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 for Firefox or FoxyProxy instead.

1

Open Firefox settings

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

2

Go to Advanced settings

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

3

Open proxy settings

Click on the Configure proxy option in the Proxy settings.

4

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.

5

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

Proxy type: HTTP, HTTPS, or SOCKS5

Host: pr.oxylabs.io

Port: 7777

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 to learn more. The table below provides an overview of available parameters and their example values.

Proxy parameter
Example
Protocols

Country entry node

Host: //us-pr.oxylabs.io

Port: 10000

HTTP, HTTPS

Country

User: customer-username-cc-US

HTTP, HTTPS, SOCKS5

State

User: customer-username-st-US_texas

HTTP, HTTPS, SOCKS5

City

User: customer-username-city-paris

HTTP, HTTPS, SOCKS5

Continent

User: customer-username-cn-NA

HTTP, HTTPS, SOCKS5

Postal code

User: customer-username-cc-US-postalcode-90210

HTTP, HTTPS, SOCKS5

ASN targeting

User: customer-username-ASN-21928

HTTP, HTTPS, SOCKS5

Session (up to 1440 minutes)

User: customer-username-sessid-qwerty123-sesstime-30

HTTP, HTTPS, SOCKS5

Sticky session

Host: //us-pr.oxylabs.io

Port: 10001

HTTP, HTTPS

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.

Datacenter Proxies

Proxy type: HTTP, HTTPS, or SOCKS5

Host: dc.oxylabs.io

Port: 8001

The port is the sequential number assigned to an IP address from the proxy list. Thus, port 8001 uses the first IP address from your list. You may also enable proxy IP rotation by setting the port to 8000.

Furthermore, you can specify the geo-location, for example, the US, by setting the Proxy username to user-USERNAME-country-US.

The port 8001 picks a random IP address but stays consistent during a session. Alternatively, you can rotate proxy IPs with each request by using port 8000.

If you want to use a specific geo-location, for example, the US, set the Proxy username to user-USERNAME-country-US.

Dedicated Datacenter Proxies (Enterprise)

Proxy type: HTTP, SOCKS5

Host: 1.2.3.4 (IP address from your proxy list)

Port: 60000 (HTTP) or 1180 (SOCKS5)

For Enterprise Dedicated Datacenter Proxies (purchased via sales), you’ll have to choose an IP address from the acquired proxy list.

Dedicated Datacenter Proxies (Self-Service)

Proxy type: HTTP, HTTPS, or SOCKS5

Host: ddc.oxylabs.io

Port: 8001

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. If you want to get a different IP with each request, change the Port to 8000 to enable proxy rotation.

ISP Proxies

Proxy type: HTTP, HTTPS, or SOCKS5

Host: isp.oxylabs.io

Port: 8001

ISP Proxies assign each port to a specific IP address and location. Port 8001 always uses the first IP from your proxy list. Use port 8000 to enable proxy rotation.

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

You will need to choose the port assigned to an IP address from the purchased proxy list, 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.

6

Save the settings

Click OK to save and close the dialog.

7

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:

You can create and manage your proxy users in our dashboard.

Proxy type
Example

Residential & Mobile proxies

User Name: customer-USERNAME

Password: PASSWORD

Datacenter proxies

User Name: user-USERNAME

Password: PASSWORD

Dedicated Datacenter proxies (Enterprise)

User Name: USERNAME

Password: PASSWORD

Dedicated Datacenter proxies (Self-service)

User Name: user-USERNAME

Password: PASSWORD

ISP proxies

User Name: user-USERNAME

Password: PASSWORD

Dedicated ISP proxies

User Name: user-USERNAME

Password: PASSWORD

8

Check your proxy connection

Visit 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.

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 and FoxyProxy.

Last updated

Was this helpful?