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

# Shadowrocket Proxy Setup Guide

> Shadowrocket is a rule-based proxy app. The iOS version is paid.

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

<Steps>
  <Step>
    Download the application from the [**App Store**](https://apps.apple.com/us/app/shadowrocket/id932747118) on your device.
  </Step>

  <Step>
    Open the app and tap **Add Server** or the **+** Icon.

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

  <Step>
    Choose the proxy **Type**: `HTTP`, `HTTPS` or `SOCKS5`.
  </Step>

  <Step>
    Fill in the following fields:

    * **Address** (e.g. `is.decodo.com` )
    * **Port** (e.g. `23001` )
  </Step>

  <Step>
    Set up the authentication:

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

  <Step>
    Tap **Save**.

    <img src="https://mintcdn.com/decodo/HeowWjVaMvMCJRIK/images/docs/5faff3ef9098862a2d9f7fd8dc81273c4afbcdfe57f88c7d5263d62bb308b500-Group_427323480.png?fit=max&auto=format&n=HeowWjVaMvMCJRIK&q=85&s=4252be51f578f8ff9513122afa60f5e5" style={{ width:"46%" }} className="mx-auto" width="1200" height="2448" data-path="images/docs/5faff3ef9098862a2d9f7fd8dc81273c4afbcdfe57f88c7d5263d62bb308b500-Group_427323480.png" />
  </Step>

  <Step>
    Tap the **Not Connected** toggle to turn on the proxy.

    <img src="https://mintcdn.com/decodo/ZzFFt4k1AMcE-z1r/images/docs/76364311aff73d1fc90ada13b84013bd55621cd4c2b4dc2b358f59f329a1725d-Group_427323481.png?fit=max&auto=format&n=ZzFFt4k1AMcE-z1r&q=85&s=8f1670c2a59ea31d0e9eb45788f5f39b" style={{ width:"46%" }} className="mx-auto" width="1200" height="2444" data-path="images/docs/76364311aff73d1fc90ada13b84013bd55621cd4c2b4dc2b358f59f329a1725d-Group_427323481.png" />
  </Step>

  <Step>
    A pop-up will appear, asking you to install a VPN Profile. Tap **OK**.

    <img src="https://mintcdn.com/decodo/ZzFFt4k1AMcE-z1r/images/docs/8522fdc34637e61f01fb5f1d19c4765a9fa038a1da033c0c5e146bdb83afb350-Group_427323482.png?fit=max&auto=format&n=ZzFFt4k1AMcE-z1r&q=85&s=1c14d42202af6e4dae89cc35ce49c93d" style={{ width:"46%" }} className="mx-auto" width="1200" height="872" data-path="images/docs/8522fdc34637e61f01fb5f1d19c4765a9fa038a1da033c0c5e146bdb83afb350-Group_427323482.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.

## Android Proxy Setup

<Steps>
  <Step>
    Download the application from the [**Google Play**](https://play.google.com/store/search?q=shadowrocket\&c=apps) Store on your device.
  </Step>

  <Step>
    Open the app, tap the **+** Icon, then select **Type manually**, and finally **Socks**.

    <img src="https://mintcdn.com/decodo/HeowWjVaMvMCJRIK/images/docs/436c73484971834b6cc1432e132b7f041d39dfb7e34b298cb96d1b66626f4a30-Group_427323510.png?fit=max&auto=format&n=HeowWjVaMvMCJRIK&q=85&s=00b4aa88aed2611211e2968f8f7427fc" alt="" width="3648" height="2380" data-path="images/docs/436c73484971834b6cc1432e132b7f041d39dfb7e34b298cb96d1b66626f4a30-Group_427323510.png" />
  </Step>

  <Step>
    Fill in the following fields:

    * **Remarks**: Choose any name for your proxy profile.
    * **Address** (e.g. `gate.decodo.com` )
    * **Port** (e.g. `7000` )
  </Step>

  <Step>
    Set up the authentication:

    * **User**: Proxy username (e.g., `user-proxyusername-session-1-sessionduration-60-country-us`).
    * **Password**: Proxy password.
          <Warning>
            * Ensure you are using **advanced parameters** directly in the proxy username to specify the **location** and keep the IP from **rotating** with residential and mobile proxies.
            * Refer to the [**Common Issues**](https://help.decodo.com/docs/shadowrocket-integration?isFramePreview=true#socks5) section below to learn how.
          </Warning>
  </Step>

  <Step>
    Next, tap the **checkmark icon** to confirm the setup.
  </Step>

  <Step>
    Finally, tap the **paper place icon** to activate the proxies.

    <img src="https://mintcdn.com/decodo/IsWPiMoisao6W8vC/images/docs/d462aff21900662e751510302b105cff8e32dad796bd71fbfbd98efd33c6dc51-Group_427323511.png?fit=max&auto=format&n=IsWPiMoisao6W8vC&q=85&s=a351a8c7b1d8ecf2f72a3d80bd0a43b3" style={{ width:"64%" }} className="mx-auto" width="2424" height="2380" data-path="images/docs/d462aff21900662e751510302b105cff8e32dad796bd71fbfbd98efd33c6dc51-Group_427323511.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>