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

SessionBox

Set up SessionBox with Oxylabs Proxies to manage multiple browser sessions. Step-by-step guide for SessionBox extension and Workstation.

SessionBox extension allows you to securely and anonymously manage unlimited active web browsing sessions.

This guide will showcase how to set up the following Oxylabs proxies with the SessionBox extension and Workstation:

  • Residential & Mobile Proxies

  • Datacenter Proxies

  • Dedicated Datacenter Proxies (Enterprise)

  • Dedicated Datacenter Proxies (Self-service)

  • ISP Proxies

  • Dedicated ISP Proxies

SessionBox extension

Step 1

Download the SessionBox extension for Chrome or Opera. For Firefox, visit the official website and click Install in the top-right corner.

Step 2

Open the add-on, create a new account or log in, or continue without it.

Step 3

Click the three horizontal lines to open a menu, and click Settings.

SessionBox settings

Step 4

Navigate to the Proxy tab and click Add New to create a profile.

Add new proxy

Step 5

Name your profile and enter the details of your chosen proxy type:

Residential & Mobile Proxies

Type: HTTP, HTTPS, SOCKS5

Address: 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.

Datacenter Proxies

Type: HTTP, HTTPS, SOCKS5

Address: 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)

Type: HTTP or SOCKS5

Address: 1.2.3.4 (IP address from your proxy list)

Port: 60000 (HTTP), 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)

Type: HTTP, HTTPS, SOCKS5

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

Type: HTTP, HTTPS, SOCKS5

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

Type: HTTP, HTTPS, SOCKS5

Address: 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.

Step 6

Scroll down the same window to enter your Oxylabs proxy user username and password, then Save the settings.

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

Step 7

Once you add the proxy, you must assign it to a new session. Visit any website and open the add-on again. Click the New Stored Session button.

New Stored Session

Step 8

A new tab will open. Navigate to the add-on again, click the three dots next to your new session, and select Settings.

Settings button

Step 9

Go to the Other tab and select your created profile under the Proxy section.

Other proxy settings

That’s all! You have set up Oxylabs Residential Proxies with SessionBox extension,

SessionBox workstation

Step 1

Visit the official product page, click Install in the top-right corner, download the setup and install it. Use your login details to log in or create a new account.

Step 2

Once logged in, click the three dots in the top-right corner.

Workstation settings

Step 3

Click Proxy Manager.

Proxy manager

Step 4

Click Add New.

New proxy

Step 5

Name your profile, choose the appropriate connection Type, and add the following information according to your chosen proxy type and finish clicking Save:

Proxy login details

Residential & Mobile Proxies

Type: HTTP, HTTPS, SOCKS5

Address: pr.oxylabs.io

Port: 7777

Username: customer-USERNAME

Password: PASSWORD

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.

Datacenter Proxies

Type: HTTP, HTTPS, SOCKS5

Address: dc.oxylabs.io

Port: 8001

Username: user-USERNAME

Password: PASSWORD

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)

Type: HTTP or SOCKS5

Address: 1.2.3.4 (IP address from your proxy list)

Port: 60000 (HTTP), 1180 (SOCKS5)

Username: USERNAME

Password: PASSWORD

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)

Type: HTTP, HTTPS, SOCKS5

Address: ddc.oxylabs.io

Port: 8001

Username: user-USERNAME

Password: PASSWORD

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

Type: HTTP, HTTPS, SOCKS5

Address: isp.oxylabs.io

Port: 8001

Username: user-USERNAME

Password: PASSWORD

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

Type: HTTP, HTTPS, SOCKS5

Address: disp.oxylabs.io

Port: 8001

Username: user-USERNAME

Password: PASSWORD

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.

Step 6

Check which country your session is connected to by clicking the Name of your proxy profile found on the right side of the search bar.

Check country

Step 7

To access additional proxy settings, click on the three dots and select General Settings. A new window will appear, allowing you to adjust the use according to your needs.

Additional proxy settings

That's it! You have successfully integrated Oxylabs proxies with SessionBox workstation.

Last updated

Was this helpful?