> 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/sessionbox.md).
# SessionBox
[**SessionBox**](https://sessionbox.io/discover) 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**](#sessionbox-extension) and [**Workstation**](#sessionbox-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**](https://chrome.google.com/webstore/detail/sessionbox-multi-login-to/megbklhjamjbcafknkgmokldgolkdfig) the **SessionBox extension** for Chrome or Opera. For Firefox, visit the [**official website**](https://sessionbox.io/discover) 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**.
### **Step 4**
Navigate to the **Proxy** tab and click **Add New** to create a profile.
### **Step 5**
Name your profile and enter the details of 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
**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](/products/proxies/residential-proxies.md) to learn more.
#### Datacenter Proxies
**Type:** `HTTP`, `HTTPS`, `SOCKS5`
**Address:** `dc.oxylabs.io`
**Port:** `8001`
{% tabs %}
{% tab title="Pay-per-IP subscription" %}
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 subscription" %}
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)
**Type:** `HTTP` or `SOCKS5`
**Address:** `1.2.3.4` (IP address from your [proxy list](/products/proxies/dedicated-datacenter-proxies/enterprise/proxy-lists.md))
**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](/products/proxies/dedicated-datacenter-proxies/enterprise/proxy-lists.md).
#### 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](/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
**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](/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
**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](/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).
### **Step 6**
Scroll down the same window to enter your Oxylabs proxy user **username** and **password**, then **Save** the settings.
{% hint style="info" %}
You can create and manage your proxy users in our [**dashboard**](https://dashboard.oxylabs.io/en/)**.**
{% endhint %}
| 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
|
{% hint style="warning" %}
Make sure to add the `customer-` or `user-` prefix to your username if your proxy type requires it.
{% endhint %}
### **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.
### **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.**
### **Step 9**
Go to the **Other** tab and select your created profile under the **Proxy** section.
That’s all! You have set up Oxylabs Residential Proxies with SessionBox extension,
## SessionBox workstation
### **Step 1**
Visit the [**official product page**](https://sessionbox.io/products/workstation)**,** 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.
### **Step 3**
Click **Proxy Manager**.
### **Step 4**
Click **Add New.**
### **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**:
* [**Residential & Mobile Proxies**](#residential-and-mobile-proxies-1)
* [**Datacenter Proxies**](#datacenter-proxies-1)
* [**Dedicated Datacenter Proxies (Enterprise)**](#dedicated-datacenter-proxies-enterprise-1)
* [**Dedicated Datacenter Proxies (Self-service)**](#dedicated-datacenter-proxies-self-service-1)
* [**ISP Proxies**](#isp-proxies-1)
* [**Dedicated ISP Proxies**](#dedicated-isp-proxies-1)
#### Residential & Mobile Proxies
**Type:** `HTTP`, `HTTPS`, `SOCKS5`
**Address:** `pr.oxylabs.io`
**Port:** `7777`
**Username:** `customer-USERNAME`
**Password:** `PASSWORD`
{% hint style="warning" %}
Make sure to use `customer-` prefix with your username.
{% endhint %}
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.
#### Datacenter Proxies
**Type:** `HTTP`, `HTTPS`, `SOCKS5`
**Address:** `dc.oxylabs.io`
**Port:** `8001`
**Username:** `user-USERNAME`
**Password:** `PASSWORD`
{% hint style="warning" %}
Make sure to use `user-` prefix with your username.
{% endhint %}
{% tabs %}
{% tab title="Pay-per-IP subscription" %}
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 subscription" %}
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)
**Type:** `HTTP` or `SOCKS5`
**Address:** `1.2.3.4` (IP address from your [proxy list](/products/proxies/dedicated-datacenter-proxies/enterprise/proxy-lists.md))
**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](/products/proxies/dedicated-datacenter-proxies/enterprise/proxy-lists.md).
#### Dedicated Datacenter Proxies (Self-service)
**Type:** `HTTP`, `HTTPS`, `SOCKS5`
**Address:** `ddc.oxylabs.io`
**Port:** `8001`
**Username:** `user-USERNAME`
**Password:** `PASSWORD`
{% hint style="warning" %}
Make sure to use `user-` prefix with your username.
{% endhint %}
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
**Type:** `HTTP`, `HTTPS`, `SOCKS5`
**Address:** `isp.oxylabs.io`
**Port:** `8001`
**Username:** `user-USERNAME`
**Password:** `PASSWORD`
{% hint style="warning" %}
Make sure to use `user-` prefix with your username.
{% endhint %}
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
**Type:** `HTTP`, `HTTPS`, `SOCKS5`
**Address:** `disp.oxylabs.io`
**Port:** `8001`
**Username:** `user-USERNAME`
**Password:** `PASSWORD`
{% hint style="warning" %}
Make sure to use `user-` prefix with your username.
{% endhint %}
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).
### **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.
### **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.
That's it! You have successfully integrated Oxylabs proxies with SessionBox workstation.
---
# 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/sessionbox.md?ask=&goal=
```
`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.