# Shadowrocket

**Shadowrocket** is a powerful app that lets you securely route traffic through a proxy connection. Follow this guide to integrate your **9Proxy Residential Proxy** with **Shadowrocket**.

## 1. Before You Begin

Make sure you’ve already:

* Created a 9Proxy sub-user
* Generated an active proxy session

Not sure how to do that? View the proxy setup guide [here](https://docs.9proxy.com/getting-started/residential-proxy-by-gb/proxy-generation).

## 2. Step-by-Step Setup

{% stepper %}
{% step %}

#### Install & Launch Shadowrocket

Download **Shadowrocket** from the App Store and open the app.
{% endstep %}

{% step %}

#### Add a New Proxy Server

Tap “**Add Server**” on the home screen.
{% endstep %}

{% step %}

#### Select Proxy Type

In the new window, tap “**Type**” and choose either HTTP or SOCKS5. Then go back to the previous screen.
{% endstep %}

{% step %}

#### Enter Proxy Details

Fill in your proxy credentials as follows:

<table><thead><tr><th width="200">Field</th><th>What to Enter</th></tr></thead><tbody><tr><td>Address</td><td>Your proxy IP (e.g., 38.180.149.107)</td></tr><tr><td>Port</td><td>Your proxy port (e.g., 17521)</td></tr><tr><td>User</td><td>Structured 9Proxy username (see below)</td></tr><tr><td>Password</td><td>Your 9Proxy  sub-account password</td></tr></tbody></table>

**Username Format**

{% code overflow="wrap" %}

```
<subaccount>-country-<country_code>-st-<state_code>-city-<city_code>-isp-<isp_code>-ssid-<session_id>-sst-<session_time>
```

{% endcode %}

{% hint style="info" %}
The username includes your proxy targeting settings like country, session ID, etc. For help creating your custom proxy username, refer to [this guide](https://docs.9proxy.com/getting-started/residential-proxy-by-gb/making-requests).
{% endhint %}

**Example Configuration:**

<figure><img src="https://content.gitbook.com/content/OOgi9NdDRekszwQ8AKkY/blobs/lnqa0aTqMetQNNO2BOiP/AD_4nXcM55psvu42F2cRtbvYB95IovEA1FsD69j1gCvRiGHtXBtc0zbOnBP45rIKYgCiVkLLFRyTQkgotTrHm3wweldxg3NR%20N3s9S4GB9Z4G5aB_cGKOFbrY4fw8GfPmzUF9YHEg7WZjg" alt=""><figcaption></figcaption></figure>

* **Proxy Host**: 38.180.149.107
* **Port**: 17521
* **Username**: useruser123-country-US-ssid-rhdN1907ma
* **Password**: X12345678
  {% endstep %}

{% step %}

#### Save & Activate the Proxy

Press the back arrow (top-left), then toggle the switch under "Not Connected" to activate your proxy.
{% endstep %}

{% step %}

#### Allow VPN Configuration

If prompted, tap “**Allow**” to let **Shadowrocket** add a VPN profile.

Enter your iPhone passcode to confirm.
{% endstep %}
{% endstepper %}

## 3. That’s It!

Your proxy is now active. To verify, visit: <https://ipinfo.io/what-is-my-ip>

Need help? Our support team is here for you anytime.
