This guide is for anyone installing Shadowrocket on an iPhone or iPad for the first time. Check your device and App Store account, verify the app name, developer, and app ID, then complete the purchase and download. It also covers what to do if you can't find the app, the download doesn't start after purchase, or you need to install it on another device, plus settings to check when you first open the app. Buying the app does not provide a working connection; connecting requires a service and subscription you already have.
1. Before you buy: Check your device, account, and how to get the app
First, confirm which device you're installing the app on. Get the iPhone / iPad version from the App Store for a one-time $2.99 purchase. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. If you're using another platform, go to the app download page and choose the right version; you don't need to follow the iPhone / iPad purchase steps in this guide.
Check the App Store product page for the iPhone / iPad system requirements. Open the product page and review Compatibility rather than relying on system version numbers from older guides. The amount shown in your local currency may depend on your App Store region. Before paying, confirm the amount and currency on the purchase screen.
- Check your App Store account: Open the App Store, tap the account icon in the top-right corner, and confirm which Apple Account is being used for purchases. It may be different from the account used for iCloud on your device.
- Check your payment method: Make sure your account has a valid payment method. If you're paying with account balance, confirm it's enough to cover the total.
- Check device restrictions: If Screen Time or device management restrictions are enabled, make sure app installation and purchases are allowed. Don't keep tapping the purchase button.
- Know what you're buying: The purchase covers use of the app. It does not include a service account, subscription link, or access plan.
2. Find and verify the app: Check its name, developer, and app ID
In the App Store, enter the full English name Shadowrocket in Search. Search result placement doesn't verify an app's identity; open its product page and check the details. Similar names, keywords, or icons are no substitute for verifying the developer and app ID. If you're unsure which result is right, use the iPhone / iPad link on this site's download page to open the product page, then check the details below.
App identity
- Name
- Shadowrocket
- Developer
- Shadow Launch Technology Limited
- App ID
- 932747118
Verify the name and developer on the product page, and the app ID in its link.
What to check on the App Store page
- Link identifier
id932747118- Icon
- Rocket with blue-purple outlines on a white background
- System requirements
- Use the requirements shown on the App Store page
Use the icon as a secondary check, not as the sole reason to pay.
The app ID is a fixed identifier in the product page link, not a version number or a search result position. Use Share on the product page to view or copy the link, then check that it contains id932747118. The developer name may appear in different places as the App Store layout changes, so check the developer or provider details on the page.
If the developer shown on the product page doesn't match, stop and return to the download page to open the product page again. Don't skip verification just because a search result includes a familiar nickname. This guide uses the official product name, Shadowrocket, throughout to avoid confusion with similar names.
3. Buy and download: Follow the App Store confirmation steps
Once you've confirmed the app's identity, continue to checkout. The iPhone / iPad version costs $2.99 as a one-time App Store purchase; the Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. The App Store handles payment authentication. Your device may ask for Face ID, Touch ID, or your account password; follow the confirmation screen shown by your system.
-
Find the app
Open App Store → Search, enter Shadowrocket, and open its product page rather than relying on the search results list.
-
Verify the app
Confirm the developer is Shadow Launch Technology Limited and the product page link contains app ID 932747118.
-
Confirm the purchase
Tap the price button on the product page. Check the app name, amount, and account on the purchase confirmation screen, then authenticate as prompted.
-
Wait for the download
Stay connected to the internet and wait for the download to finish. If the button changes to Open, the app is ready to launch on this device.
-
Open it for the first time
Tap Open in the App Store or launch Shadowrocket from your Home Screen. Check Home and Config first, then set up a connection using information you already have.
Tapping the price button doesn't mean the purchase is complete, and successful authentication doesn't mean the installation has finished. Check purchase and download status separately: confirm the purchase in the App Store account's Purchase History, then check whether the product page shows Open and whether the Home Screen still shows a pending or active download.
4. Troubleshooting: Missing search results, stalled downloads, and new devices
First, identify where the problem occurs. Not finding the product page is a search or availability issue; a declined payment is an account billing issue; a purchase on record but no installation is a download or device requirements issue. Handling these separately makes it easier to find the cause than repeatedly searching or tapping Buy.
Can't find Shadowrocket in the App Store?
Check the spelling, then open the product page using the iPhone / iPad link on this site's download page. If the App Store says the app isn't available in your region, follow the message for the store associated with your account. If the page opens but you can't install the app, check Compatibility. Not finding it in search alone doesn't prove your device is unsupported.
Was my purchase successful if my payment was declined?
Go to App Store → account icon → Purchase History to see whether an order exists, then check your payment method or any pending charges as directed by the App Store. An incomplete order and a failed download are separate issues; repeatedly submitting payment won't help diagnose a network problem.
The app is stuck on Waiting on my Home Screen. Should I buy it again?
Don't buy it again yet. Check your internet connection and available storage. On an iPhone, go to Settings → General → iPhone Storage; on an iPad, check iPad Storage. Then return to the App Store to check the download status. If needed, pause and resume the download, and check for any specific error message from the store.
How do I download Shadowrocket again on a new iPhone?
Use the App Store account that made the original purchase. On the account page, look in Apps or Purchased for your apps, then find Shadowrocket and tap the redownload icon. Menu names can vary by system version. If the app still shows a price, check your App Store account and purchase history before confirming another payment.
Redownloading the app and restoring its configuration are two separate things. Your purchase history confirms your right to get the app; it doesn't mean that servers, subscription URLs, or Config settings in Home have been saved. Back up any configuration and important information separately before switching devices. Don't share subscription links containing tokens in public questions or screenshots.
5. After installation: Understand Home, Config, and routing modes
When you first open Shadowrocket, an empty Home screen with no servers or subscriptions doesn't mean the purchase failed. The App Store installs the app; you need to add your own server details separately. Home is where you view and select connection items, Config is for managing configuration files, and Settings is where you find app preferences. Purchase details aren't handled on these screens.
- Import an existing subscription: In Home, tap
+in the top-right corner → Type → Subscribe, then enter and save your own subscription URL. If the import fails, check the full URL, its expiration date, and your connection. App purchase status doesn't determine whether a subscription is valid. - Understand configs and subscriptions: A subscription typically provides or updates a server list. A Config file can contain rules and related settings. Importing a subscription doesn't automatically apply a rule configuration suited to your needs.
- Review system permissions: The first time you enable a connection, the system may ask to add a VPN configuration. Read the permission prompt before deciding whether to allow it. Adding a configuration doesn't mean the remote server has connected successfully.
- Hold off on automatic connections: Test the connection manually first, then review Settings → On Demand. On Demand controls when connections start based on conditions; it doesn't purchase the app or create server details.
Global Routing determines how traffic is handled. The comparison below describes Shadowrocket's routing modes only; it isn't a measure of connection quality. Start by testing a configuration you've verified. If something goes wrong, change one setting at a time so you can distinguish configuration issues from server issues.
Config
RecommendedRoutes traffic according to the active configuration and its rules. Use this for everyday connections only after confirming the configuration meets your needs. Check which policy FINAL points to for traffic that doesn't match an earlier rule.
Best for: Using a verified Config to route traffic by rules
Proxy
Generally routes traffic through a proxy, so you can compare its behavior with Config. It won't fix a server that's down or make an expired subscription valid again.
Best for: Checking whether a problem is related to rule selection
Direct
Generally routes traffic directly. If a destination requires a proxy, access results while Direct is selected won't tell you whether the proxy server is working.
Best for: Comparing direct access on your current network
If you see DOMAIN-SUFFIX, GEOIP, IP-CIDR, or FINAL in Config, you don't need to change them just to finish installing the app. These are rule keywords, not purchase activation codes. Keep the original configuration, then learn what each rule matches, how rule order works, and which policy it points to. Verify installation, subscription import, and rule changes as three separate steps.
Get Shadowrocket and continue setup
Get the iPhone / iPad version from the App Store for a one-time $2.99 purchase; check the App Store page for system requirements. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. Choose your device on the download page, then follow the guide to import a subscription you already have and check your configuration.