Official Manual · Troubleshooting Index
Shadowrocket Troubleshooting
Find the issue by stage: verify the store listing, install and open the app, import an existing subscription, or troubleshoot connections and rules.
Store questions apply to iPhone / iPad; installation guidance also covers Mac, Windows, Android, and Linux. Connection steps use the iPhone / iPad interface labels as examples.
Verify and purchase
Confirm the listing first, then check compatibility, storefront region, and purchase history.
See download page verification stepsHow do I verify the Shadowrocket listing on the App Store?
Check three details on the App Store product page: the developer is Shadow Launch Technology Limited, the icon matches the official icon in this page’s header, and the product page URL ends in id932747118. The app name or an icon in search results alone isn’t enough to confirm it’s the same listing. Before buying, also check the price and device compatibility shown in your store.
Is Shadowrocket available for desktop and Android? Does the purchase include servers?
Yes. The iPhone / iPad version costs $2.99 as a one-time purchase on the US App Store; check the store page for current details. The Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free. Desktop and Android installers are distributed from /dl/shadowrocket/ via this site’s download page. A one-time app purchase does not include a server subscription; import your own subscription or server details.
Can I install Shadowrocket on iPad? How do I check system requirements?
Yes. iPhone and iPad use the same App Store listing. Check the App Store page for system requirements. On iPad, open the product page and review Compatibility, then check the installed iPadOS version in Settings → General → About. If the page says your device isn’t compatible, first check whether you can update iPadOS; there’s no need to keep searching for the same app.
Can’t find Shadowrocket in the App Store? Check this first
Check the store region for your purchasing account, not your device’s language or region. Go to Settings → Apple ID → Media & Purchases → View Account → Country/Region. App availability depends on that storefront. If you need to change it, choose Change Country or Region on the same page and first review Apple’s guidance on your balance, active subscriptions, and payment method.
Do I need to buy Shadowrocket again when I replace my iPhone or iPad?
You don’t need to buy it again if you use the original purchasing account and the app is still available to redownload. On your new device, open the App Store, tap your profile picture, and find Shadowrocket under Purchased. If it’s missing, check the account used for Media & Purchases and the current storefront. Redownloading the app won’t automatically restore all your configurations, so back up any Config you want to keep before switching devices.
Install and open for the first time
Choose the right operating system and chip first, then distinguish compatibility, permissions, and connection issues based on the prompts.
See installation steps for each platformWhich Mac version should I choose: Apple Silicon or Intel?
Open the Apple menu → About This Mac. If Chip shows an Apple M-series chip, choose the Apple Silicon version on the download page. If Processor shows Intel, choose the Intel version. Both installers are .dmg files, so the extension won’t tell you which chip they’re for. If you see a message that the app isn’t supported on your Mac, check this page again rather than treating an architecture mismatch as a security block.
Mac or Windows warns that the app may be risky. What should I do the first time I open it?
Don’t open the file yet. Confirm it came from this site’s download page via /dl/shadowrocket/, and check that it matches your device’s operating system and architecture. Only consider allowing it once if the source is clear, the warning is only that the developer or publisher can’t be verified, and your device policy permits it. On macOS, look for Open Anyway under System Settings → Privacy & Security. On Windows, check More info in SmartScreen for Run anyway. Don’t bypass a block if the system reports malware, the file’s source is unknown, or the device is managed by an organization.
How can I tell a permissions issue from the wrong package when installing on Android or Linux?
On Android, first check whether your device supports arm64. If the only warning is about installation permission, verify the file’s source, temporarily allow the app you’re using to open the installer to install unknown apps, then turn that permission off afterward. On Linux, choose a package for your distribution: use deb for Debian or Ubuntu, and rpm for Fedora or RHEL. For AppImage, verify the source and make the file executable. If you get an architecture mismatch or dependency error, check your distribution and processor first; running as root isn’t a universal fix.
The connection switch won’t turn on on iPhone or iPad. What should I check?
First, check in Home that a usable SERVER is selected. The first time you connect, iOS may ask permission to add a VPN configuration; verify the app name in the prompt before confirming. If you denied permission earlier, try again from Home and see whether the prompt appears. If another VPN is in use, check whether you can disconnect it temporarily and retry. Ask your administrator about restrictions on managed devices.
The interface is in English. Which labels should I look for while following the manual?
On iPhone or iPad, find the relevant screen by task: check the connection switch and Global Routing in Home, your active setup in Config, and options such as On Demand in Settings. Use Add Server to enter details for an existing server, and Subscribe to import an existing subscription. The manual keeps these interface labels in English, so you don’t need to change your device language to find them.
Subscriptions and server imports
Use your existing subscription or server details. Confirm the input type first, then check the import result.
See how to use SubscribeShadowrocket subscription import failed. How do I find where it went wrong?
First, make sure you’re using Subscribe with the complete subscription URL provided by your service, not a login page URL or a link for sharing a single server. Copy it again from the original source, check that the ending hasn’t been cut off and no spaces were added, then retry on your current network. If you see an access-denied or expired-link message, check whether the subscription is still valid. If the format isn’t recognized, ask the original provider what format the response uses. Don’t post the full URL publicly.
Do I need to add my Shadowrocket subscription again to update it?
If the URL hasn’t changed, update the existing subscription entry in Home rather than adding another entry with the same name. After updating, expand the subscription, check that your previously selected server is still listed, then test the connection. If the URL has changed, keep the old entry until the new one imports successfully and you’ve confirmed the selected item; then decide whether to remove the old entry.
I only have server details. Should I use Subscribe?
No. If you have details for a single server, open Add Server and select the protocol that matches the information you were given. Enter the address, port, and any fields required by that protocol exactly as provided. Addresses usually don’t include a protocol prefix or path; don’t put separately requested fields into the address. For example, VLESS and Trojan require different authentication details and aren’t interchangeable. Save the entry, return to Home, select it, and test the connection.
Why didn’t scanning a QR code add the server I expected?
First, distinguish a scanning problem from an import problem. If the camera can’t read the code, check Shadowrocket’s camera permission and make sure the QR code is complete and clear. If it scans but the expected entry doesn’t appear, check whether the code contains a subscription URL or details for a single server; these appear differently in Home. If the scan returns a webpage URL, check with the original source whether it’s meant for importing. QR codes may contain credentials, so don’t share them publicly while troubleshooting.
The subscription updated, but my previously selected server disappeared. What should I do?
A successful update only means the client read the subscription content this time; it doesn’t mean every previous entry was retained. Expand the same subscription and check whether the original entry was removed or renamed. If no usable item is selected, choose another one from your subscription and test it. If rules in Config depend on a specific policy or server name, check that the reference still matches. You don’t need to delete the entire Config first.
Routing rules and troubleshooting
First make sure your device’s current network is working, then compare routing modes and rules using the same URL.
See the Settings guideWhich Global Routing mode should I use: Config, Proxy, or Direct?
Choose Config to route traffic according to rules in the active Config, which determines which requests use PROXY or DIRECT. To check whether the selected server can handle requests routed through the client, switch briefly to Proxy, often called global mode. To compare access without using a proxy server while leaving the connection switch on, choose Direct. When testing is done, switch back to your original mode.
The connection is on, but webpages won’t load. What order should I troubleshoot in?
Turn the connection off first and use the same URL to check that your device’s current network works. If public Wi-Fi requires sign-in, complete that first. Once the network is working, reconnect, confirm the selected SERVER in Home, and run Connectivity Test. If only certain domains fail, note the current Global Routing mode and check the active Config rules and DNS. Change one thing at a time, then test the same URL again.
Why isn’t a request going DIRECT after I switch to Config?
First, confirm you edited the Config that’s currently active, then check [Rule] from top to bottom. A request may match an earlier rule first; FINAL applies only when none of the preceding rules match. When testing a webpage, check not just the domain in the address bar but also other domains used to load its resources. Use Log to see the actual requests, then change the rule order once you’ve identified the rule matching unexpectedly.
The battery seems to drain faster after connecting. How can I troubleshoot On Demand?
First, review activity under Settings → Battery; don’t assume the connection icon explains the drain. Note whether you were on Wi-Fi or cellular and whether the network switched frequently, then check the On Demand conditions in Settings. If you don’t need on-demand connections, temporarily turn off On Demand and compare usage in similar network conditions. Restore the original setting afterward so other changes in network use aren’t mistaken for the cause.
Connectivity Test passed. Why should I still test the actual website?
A passing Connectivity Test only shows that the test target was reachable on that attempt; it doesn’t guarantee that the website you need will load. Actual requests from the same device may use different rules, DNS resolution, or servers. Retry the original URL that failed and note the network, Global Routing mode, and time of failure. Use those details to investigate Log, and remove subscription URLs and credentials before sharing logs.