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

# Potatso Proxy Setup Guide

> Potatso is free to use on the iPhone and supports routing connections for your apps.

## 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>

## iOS Setup

<Steps>
  <Step>
    [**Download**](https://apps.apple.com/us/app/potatso-lite/id1239860606) the application to your device.
  </Step>

  <Step>
    Open the app, and tap **Add a Proxy**.

    <img src="https://mintcdn.com/decodo/eRLuBYAbadfvmqDE/images/docs/2b17a20fbf41e5c466ec0f2b08a454056ad51d4479d2d7c6265b2cc7608b8d4d-Group_427323341.png?fit=max&auto=format&n=eRLuBYAbadfvmqDE&q=85&s=66718a1825702ef23cc4fbc4e8bd28b4" style={{ width:"46%" }} className="mx-auto" width="1200" height="2560" data-path="images/docs/2b17a20fbf41e5c466ec0f2b08a454056ad51d4479d2d7c6265b2cc7608b8d4d-Group_427323341.png" />
  </Step>

  <Step>
    Then, choose **Add** under the **Manual input** section.

    <img src="https://mintcdn.com/decodo/eRLuBYAbadfvmqDE/images/docs/1db6cd59967206067a9cfbbf2f7ae0c2d5ad00c903c797bebd52c3d9d7ae652b-Group_427323342.png?fit=max&auto=format&n=eRLuBYAbadfvmqDE&q=85&s=1c5aaa86066a1cc2211772503b4b69c9" style={{ width:"46%" }} className="mx-auto" width="1200" height="2560" data-path="images/docs/1db6cd59967206067a9cfbbf2f7ae0c2d5ad00c903c797bebd52c3d9d7ae652b-Group_427323342.png" />
  </Step>

  <Step>
    Fill in the following fields:

    * **Type**: `HTTP`, `HTTPS` or `Socks5`.
    * **Host** (e.g., `ch.decodo.com`).
    * **Port** (e.g., `29001`).
  </Step>

  <Step>
    Set up the authentication:

    * **Authentication**: Choose **Password**.
    * **User**: Proxy username.
    * **Password**: Proxy password.
  </Step>

  <Step>
    Tap **Save**.

    <img src="https://mintcdn.com/decodo/IsWPiMoisao6W8vC/images/docs/d38f34ae240ac0c12aab3ea20808b6d9d952edd62f88cf0114bd4b8df79772f6-Group_427323350.png?fit=max&auto=format&n=IsWPiMoisao6W8vC&q=85&s=d70d09c0433bb12391794f87fda03539" style={{ width:"46%" }} className="mx-auto" width="1200" height="1540" data-path="images/docs/d38f34ae240ac0c12aab3ea20808b6d9d952edd62f88cf0114bd4b8df79772f6-Group_427323350.png" />
  </Step>

  <Step>
    Tap the **Play** icon to activate the proxies.

    <img src="https://mintcdn.com/decodo/7Hj3tfc-1rGMirwk/images/docs/bcb4b2c89532d129975474214aa1ebfd427fcb6ad3e9f0df4c8d9b324fc9979c-Group_427323349.png?fit=max&auto=format&n=7Hj3tfc-1rGMirwk&q=85&s=8b2107d13940038c59a121e4369fb31b" style={{ width:"46%" }} className="mx-auto" width="1200" height="2560" data-path="images/docs/bcb4b2c89532d129975474214aa1ebfd427fcb6ad3e9f0df4c8d9b324fc9979c-Group_427323349.png" />
  </Step>

  <Step>
    If prompted, tap **Allow**, and enter your iPhone password so the application can add VPN configurations.

    <img src="https://mintcdn.com/decodo/IsWPiMoisao6W8vC/images/docs/fc0d745063409958d0f088a3a261c4dc81761cb4f7335f3b89cdcce3dc097aa2-Group_427323348.png?fit=max&auto=format&n=IsWPiMoisao6W8vC&q=85&s=ad3bfaf3d8dc82c8bd86fd3d158f8b1f" style={{ width:"46%" }} className="mx-auto" width="1200" height="1072" data-path="images/docs/fc0d745063409958d0f088a3a261c4dc81761cb4f7335f3b89cdcce3dc097aa2-Group_427323348.png" />

    <img src="https://mintcdn.com/decodo/IsWPiMoisao6W8vC/images/docs/e757991b77f933a899dcc79a98865fa000e9de62eda3a4be1b6051010adb84d5-Group_427323347.png?fit=max&auto=format&n=IsWPiMoisao6W8vC&q=85&s=1ebf91f8854f8fb198345db90c811e0d" style={{ width:"46%" }} className="mx-auto" width="1200" height="1788" data-path="images/docs/e757991b77f933a899dcc79a98865fa000e9de62eda3a4be1b6051010adb84d5-Group_427323347.png" />
  </Step>
</Steps>

### Verify the Connection

* Open a browser and 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).

### `SOCKS5`

**Residential and Mobile Proxy Support Limitations**

<AccordionGroup>
  <Accordion title="Country Targeting" icon="gear">
    The `gate.decodo.com` **endpoint** and the `7000` **port** must be used to utilize `SOCKS5` Residential or Mobile proxies. **Country** endpoints, such as `us.decodo.com`, will not function!

    You can target specific locations instead by specifying the location in your username using **advanced** **parameters**:

    * e.g.: `user-username-country-us` will connect to the **USA** pool.
  </Accordion>

  <Accordion title="Proxy Rotation" icon="gear">
    To get a **sticky** `SOCKS5` Residential or Mobile proxy in a **tool**, you must use a `session` **parameter**. Otherwise, the proxy will always rotate even with a set `sessionduration` parameter.

    * e.g.: `user-username-session-abc123-sessionduration-30` will connect to the same session.
      * The **session ID** name can be defined by any string of your choice.
  </Accordion>
</AccordionGroup>

<Note>
  Learn more in our **advanced** **parameter** guides for [**Residential**](https://help.decodo.com/docs/residential-proxy-advanced-parameters/) and [**Mobile**](https://help.decodo.com/docs/mobile-proxy-advanced-parameters/) proxies.
</Note>

### 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>