> ## Documentation Index
> Fetch the complete documentation index at: https://help.decodo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SessionBox Proxy Setup Guide

## Getting Started

Before proceeding, ensure you have:

* No other VPN or proxy active.
* The **proxy endpoint** and **port** (e.g., `us.decodo.com:10101`).
* Your **proxy username** and **password** (or a **whitelisted IP** set).

<Tip>
  **Proxy Guides**

  Learn how to find **proxy details** in your dashboard for each proxy type [**here**](https://help.decodo.com/docs/proxy-quick-start-guides).
</Tip>

## Proxy Setup

<Steps>
  <Step>
    Set up and log in to the **SessionBox** extension on your browser.
  </Step>

  <Step>
    In the extension, click on one of the symbols near the site's name to create a new session.

    <img src="https://mintcdn.com/decodo/ZzFFt4k1AMcE-z1r/images/docs/9ef0d0e9c35026c22a1cb355ed635ba4065a67e9b3870566baa21f317720f2c8-SessionBox1.png?fit=max&auto=format&n=ZzFFt4k1AMcE-z1r&q=85&s=900cada45a72649aec37a41a43cbb56a" style={{ width:"46%" }} className="mx-auto" width="1420" height="2224" data-path="images/docs/9ef0d0e9c35026c22a1cb355ed635ba4065a67e9b3870566baa21f317720f2c8-SessionBox1.png" />
  </Step>

  <Step>
    Select the website for which you have created the new session and go to session settings (click on the **three dots** and then on the **settings menu** symbol).
  </Step>

  <Step>
    Select the **Other** tab. In the **Proxy** dropdown menu, select **Add new**.
  </Step>

  <Step>
    In the **Add proxy** menu:

    * Enter any name you wish.
    * For **Type**, select HTTP.
    * In the **Address** and **Port** fields, enter your chosen endpoint and its port. E.g. `us.decodo.com` and `10003`.
    * In the **Username** and **Password** fields, enter the credentials of your proxy user accordingly. If you are using a whitelisted IP address, you can skip these fields. Learn more about our [**authentication methods**](https://help.decodo.com/docs/proxy-authentication-guides#/).

    <img src="https://mintcdn.com/decodo/ZzFFt4k1AMcE-z1r/images/docs/79f5c5bf53c31be155b8764b50ba234368164116b2671e5ae6ecd4dca8dbf45f-SessionBox4.png?fit=max&auto=format&n=ZzFFt4k1AMcE-z1r&q=85&s=70b4ed128aa1c01f861017b891da0e57" style={{ width:"46%" }} className="mx-auto" width="1076" height="1712" data-path="images/docs/79f5c5bf53c31be155b8764b50ba234368164116b2671e5ae6ecd4dca8dbf45f-SessionBox4.png" />
  </Step>

  <Step>
    Click **Save**. The proxies will be active during the session you have set them up for.
  </Step>
</Steps>

### Verify the Connection

* Visit [**ip.decodo.com**](https://ip.decodo.com/). If successful, your IP address will display the location of the proxy.

***

## Common Issues

### Blocklist

⚠️ Please be aware that we [**restrict access to some websites**](https://decodo.com/faq/general/do-you-have-any-blocked-sites).

### Direct IP

<AccordionGroup>
  <Accordion title="Direct IP Parameter Support" icon="gear">
    If you buy an IP list, you can specify which IPs to connect to using the **direct** `ip` parameter in the proxy username: `user-username-ip-x.x.x.x`

    * Supported products: **DC Pay/IP**, **Dedicated DC**, **ISP Pay/IP**, **Dedicated ISP** plans.
    * Products that offer access to the full proxy pool, such as residential proxies, do not support this parameter.
  </Accordion>

  <Accordion title="IP:PORT Format" icon="gear">
    * Decodo proxies don't support an `IP:PORT` format by default.
    * You must use the **endpoint** rotator format (e.g., `us.decodo.com:10101`).
    * If necessary, try the workaround [**here**](https://help.decodo.com/docs/how-to-get-ip-port-format#/), but it only works temporarily before requiring another setup update.
  </Accordion>
</AccordionGroup>

### Troubleshooting

If you experience any other issues, check out our main [**troubleshooting**](https://help.decodo.com/docs/proxy-troubleshooting) section.

***

<Columns cols={2}>
  <Card title="Support" href="https://direct.lc.chat/12092754" cta="Let's chat!">
    Need help or just want to say hello? Our support is available 24/7. \
    You can also reach us anytime via email at [support@decodo.com](mailto:support@decodo.com).
  </Card>

  <Card title="Feedback" href="mailto:feedback@decodo.com" cta="Share feedback">
    Can't find what you're looking for? Request an article! \
    Have feedback? Share your thoughts on how we can improve.
  </Card>
</Columns>