Shadowrocket setup guide

Shadowrocket is a paid iOS app from the App Store, for iPhone, iPad and Apple silicon Macs. It isn't listed in every App Store region; if you can't find it, sign in to the App Store with an Apple ID from another region to buy it.

The pictures are simplified illustrations. Apps change between versions, so yours may look slightly different.

1. Install

  1. Search for Shadowrocket in the App Store, or use the button above. Buy and install it. If it doesn't show up in your region, switch to an Apple ID from another region.

  2. When you first open it, allow Shadowrocket to add a VPN configuration.

2. Import your subscription

  1. On your iPhone, open the Subscription page of the user center and tap Add to Shadowrocket. Choose Open when Safari asks.

    User center: "Add to Shadowrocket" button
  2. Shadowrocket adds a subscription named LumSub and downloads the server list.

  3. If nothing happens: copy your subscription link, open Shadowrocket, tap + at the top right, set the type to Subscribe, paste the link into URL, enter LumSub as the remark and tap Done.

    Manual add: type Subscribe, URL pasted

3. Connect

  1. The first row of the subscription shows your expiry date. Below it, the entries 📅 Expires and 🌐 Renew are information only. Pick a server under them — a lower latency number is usually faster.

    Server list with 📅 / 🌐 entries on top
  2. Turn on the connection switch at the top.

    Connected: switch turned on
  3. In Settings → Subscription, turn on Update on open to keep the server list current. To update by hand, pull down on the home screen, or swipe left on the subscription and tap Update.

    Settings → Subscription → Update on open

FAQ

What are the entries at the top of the server list?

Those are LumSub status notices, such as your expiry date or renewal reminders. They can't be used to connect — pick a server below them.

No servers after importing?

Swipe left on the subscription and tap "Update". If that doesn't help, check that your plan is active, or try a backup subscription link from the Backup access page.

Some servers (for example Hysteria 2 or AnyTLS) are missing?

Older versions of Shadowrocket can't use every protocol, so those servers are left out. Update Shadowrocket in the App Store, then update the subscription.

Told you have too many devices?

Your plan limits how many devices can be online at once. Disconnect a device you're not using and try again after a few minutes.

← All setup guides · Troubleshooting