This guide is for anyone installing Shadowrocket on Android for the first time or troubleshooting downloads that won't start in WeChat, blocked installation permissions, or the VPN authorization prompt on first connection. Follow the steps in order: download in a browser → allow installs from the current source → open the APK → import your existing configuration → authorize the connection. This helps pinpoint whether the issue is with downloading, installing, or connecting, rather than mistaking a subscription problem for an installation failure.
Before you install: check your platform and download source
Get the Android installation package from the Android section of our download page. Don't rely on a chat attachment's filename to verify its source, and don't mistake a website shortcut for an installed app. Normally, the browser first records the download; then Android's installer displays the app details and asks you to confirm.
There are two ways to get Shadowrocket: the iPhone / iPad version is available on the App Store for a one-time $2.99 purchase from Shadow Launch Technology Limited; check the App Store page for system requirements. The Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free. Use the download page for all download steps in this guide; Android users don't need to make the iPhone / iPad App Store purchase.
- Check your device: Go to Settings → About phone to view your device details. Use the Android installation package from the download page, not an installer for a desktop platform.
- Check available storage: You need free space to download and install the app. If Android reports insufficient storage, remove files you no longer need and download the package again. Don't keep trying to open an incomplete download.
- Prepare your configuration: Importing a configuration later requires a service and subscription that you already have. Installing the app does not create a working server. This site does not provide, sell, or recommend servers, subscriptions, or service providers.
Download and install the APK: follow these five steps
Download the file in your system browser before changing installation permissions. Android usually grants permission to install unknown apps per source app: a browser and a file manager count as separate sources, so allowing one doesn't authorize the other. The menu names below reflect common Android labels; names and paths may vary by manufacturer.
-
Open the download page
In your system browser, visit this site's download page and select the Android section. If the page is open in WeChat, first choose “Open in browser” from the WeChat menu, then download the file.
-
Wait for the download to finish
Open the browser menu → Downloads and wait until the download is marked complete. Then tap the file ending in
.apk. If the download is paused, failed, or still in progress, resume it or download it again first. -
Allow the current source
If Android blocks the installation, tap Settings in the prompt, check which source app is shown at the top of the page, then enable Allow from this source. Don't grant this permission in bulk to unrelated apps.
-
Return and confirm the installation
Go back to the installer and confirm. If you return to the browser instead, open the completed APK again from Downloads. Review the app details shown by Android; if a security warning appears, first check the source and the reason for the warning.
-
Open the app and revoke permission
When installation is complete, open Shadowrocket and check that the main screen loads. Return to the same system permission page and turn off installation permission for that source. If you need to update the app later, enable it temporarily for the app you're actually using to start the installation.
Can't open a download in WeChat? Switch to your system browser
WeChat's built-in webview handles downloads differently from a standalone browser. If tapping the link leaves you on the article, asks you to switch browsers, or doesn't create a download entry, fix how the page is opened first instead of repeatedly changing installation permissions. The APK may not be saved on your device yet, so Android's installer hasn't started.
- Tap the menu in the top-right corner of the WeChat page and choose “Open in browser.” If Android lists multiple apps, choose the standalone browser you normally use.
- If that option isn't available, copy the page address, paste it into your system browser's address bar, and open the site's download page there.
- Tap the Android download link again and check Downloads in your browser. Don't judge whether the download succeeded only by whether the webpage button changed color.
- If you see multiple downloads with the same name, open only one marked complete. After confirming installation, delete the duplicate files.
If the system browser also fails to download the file, use the same browser to open another page on this site. This helps distinguish a page-loading problem from a file-download problem. If pages load but the download stops immediately, note the browser's error message and check available storage, the download location, and your network connection. You can switch between Wi-Fi and mobile data and try once more; avoid starting multiple downloads at the same time.
Installation permission and VPN authorization: handle them separately
On first use, you'll encounter two different types of system authorization. Installation permission controls which apps can start installing an APK; VPN authorization lets Shadowrocket establish a VPN connection on your device. Revoking a browser's installation permission won't remove Shadowrocket or revoke its VPN authorization.
APK installation permission
- Common path
- System Settings → Apps → Special app access → Install unknown apps
- App to authorize
- The browser or file manager used to open the APK
- Permission toggle
- Allow from this source
- When to change it
- After downloading, when Android blocks the source as you open the APK
If you can't find this path, search Settings for “Install unknown apps.” Menu names vary by device.
VPN connection authorization
- Where to start
- Shadowrocket → Home → connection toggle
- App to authorize
- Shadowrocket
- System prompt
- VPN connection request
- When to change it
- When you first try to connect after confirming your configuration
Review the system prompt and confirm. The app can open without establishing a connection if you haven't granted authorization.
If Android blocks the APK again when you open it from a file manager, check which app is shown on the authorization page. Permission granted to your browser doesn't automatically apply to the file manager. If you still need to install the app, authorize only the source you're actually using, then turn permission off when you're done.
First launch: import a configuration and check your connection mode
After opening the app, note the different roles of Home, Config, and Settings: Home shows your servers and connection status, Config manages rule configurations, and Settings controls app preferences. Successful installation only means the app can run; it doesn't confirm that a server, subscription, or rules are working.
- On Home, tap “+” in the top-right corner, set Type to Subscribe, then paste and save a subscription link you already have. Subscription URLs are sensitive; don't include the full link in public screenshots.
- Go back to Home and update the subscription. Check that server entries appear. If the list is empty, verify that the URL is complete and the subscription is still active, and check that the response contains a supported subscription format.
- If you also have a rule configuration, open Config and confirm that the intended file is imported and enabled. A server subscription and a rule configuration are separate; importing servers doesn't switch your rules.
- On Home, check Global Routing, select a server, and turn on the connection. Approve the VPN authorization prompt, then test the destinations you need to reach.
Global Routing determines how traffic is handled. The modes below describe Shadowrocket's own connection behavior. Config doesn't mean “send all traffic directly,” and Proxy can't make an unavailable server work.
Config
RecommendedRoutes traffic according to the rules and policies in the currently enabled configuration. Rules are generally matched from top to bottom; the result depends on the policy that matches. Check the source and contents of a configuration before using it.
Best for: everyday use with a known rule configuration and traffic routed by destination.
Proxy
Sends traffic within the app's interception scope to the proxy policy instead of routing it by destination rules in Config. Use it briefly to check whether rules are affecting a particular destination.
Best for: temporarily troubleshooting rule matches when the server is known to be working.
Direct
Connects traffic within the app's interception scope directly to its destinations. Even with the connection toggle on, this mode does not mean traffic is going through a remote server.
Best for: comparing behavior on your local network to see whether the proxy route is involved.
If you select Scene, also check the settings assigned to that scene; the mode name alone doesn't tell you the final route. When troubleshooting for the first time, change one thing at a time: verify the server, check Global Routing, then inspect the specific rules. Changing the subscription, configuration, and network all at once makes the cause harder to identify.
Common errors: troubleshoot by stage
When documenting a problem, distinguish among “not downloaded,” “can't install,” “app won't open,” and “connected but access is failing.” Each points to a different fix. Screenshots can show the full error message, but hide subscription URLs, server addresses, passwords, and other credentials.
The download finished, but Android says “There was a problem parsing the package.” What should I do?
First, check Downloads in your browser to confirm the file finished downloading. Download it again from this site's download page to rule out an interrupted transfer. If parsing still fails, check the compatibility notes on the download page against your device's system details. Don't just change the file extension, and don't try to install a file saved from an error page as an APK.
Why am I being asked to allow installations again?
Check whether you opened the file from a browser or a file manager. In System Settings → Apps → Special app access → Install unknown apps, check which source is actually being used. Enable Allow from this source only for that source, then turn it off when installation is complete.
The update says “App not installed.” Should I uninstall first?
Don't uninstall right away. Note the full error message, check available storage, device management restrictions, and package compatibility, and confirm that the package came from this site's download page. If you have a configuration, back up anything you can export first. Uninstalling may delete local data, so it shouldn't be your first troubleshooting step.
Web pages won't load after connecting. Does that mean the APK wasn't installed correctly?
If the app opens and starts connecting, first check VPN authorization, the server selected on Home, and whether Global Routing is set to Direct. Then check whether all destinations fail or only some do. If all fail, check the server and network first; if only some fail, inspect the rules and DNS settings in Config.
The connection drops after the screen has been locked for a while. Should I reinstall?
First, go to System Settings → Apps → Shadowrocket → Battery and check background activity and battery restrictions. Menu names vary by device; some manufacturers also have a separate background activity manager. Adjust the settings as needed, then test with the app in the foreground and with the screen locked. Reinstalling won't automatically change system background restrictions.
After installation: cleanup and update checks
After testing a connection, keep any configuration backups you need and revoke installation permission for the browser or file manager. For future updates, use this site's download page, then install the completed download as prompted by Android. If an installation conflict occurs, keep the existing app and data while you investigate the error. Don't repeatedly try files from unverified sources.
- Permission cleanup: Turn off Allow from this source for the source you used. Keep VPN authorization enabled if you need it.
- File cleanup: Once you've confirmed the app opens, delete duplicate or incomplete APK downloads so you don't open an old file by mistake next time.
- Configuration check: Verify the selected server, enabled Config, and Global Routing. Note the network conditions needed to reproduce the problem, and don't share sensitive credentials.
- Next steps: For help importing a subscription and getting connected, follow the tutorial. To get Shadowrocket for another device, return to the download page and select your platform.