To install Shadowrocket on Android, download the arm64 APK from our download page, then allow the browser or file manager you use to open it to install apps from that source. This guide covers first-time installation, blocked installs, and downloads that fail in WeChat. Follow the steps in order to identify whether the issue is with the file, system permissions, or later configuration.
1. Check Your Device and Download Options
The Android version is provided as an APK, with an arm64 download option on our download page. arm64 refers to the processor and app runtime architecture, not the Android version. A 64-bit processor does not necessarily mean the installed system can run 64-bit apps; some devices use a 32-bit system. If you see a compatibility warning, check the system architecture as well.
Open the Shadowrocket download page and find the Android section. Do not try to find other packages by renaming files or changing characters in the download URL. All downloads in this guide start from the download page; installation files are served from /dl/shadowrocket/.
- Device details: Open Settings → About phone to check your model and Android version. Menu names may vary by manufacturer.
- Check the architecture: If the device specifications list
arm64-v8a, that confirms the supported app architecture stated by the manufacturer. “Octa-core” alone does not tell you the architecture. - Storage space: You need room for both the downloaded file and the installed app. If storage is low, remove files you no longer need, then try again.
- Two ways to get Shadowrocket: iPhone and iPad: a one-time $2.99 purchase on the App Store. Mac (Apple silicon and Intel), Windows, Android, and Linux: free. For iPhone and iPad system requirements, see the App Store listing.
2. Download and Install the APK in a Browser
Use your system browser for the full process so you can find the download and identify which app needs permission. Wait for the browser to confirm the download is complete before opening the file. Tapping a download button on a webpage does not mean the file has finished downloading.
-
Open the Download Page
Open our download page in your system browser, find the Android section, and select the arm64 APK. If you are viewing this page in WeChat, switch browsers as described in the next section.
-
Wait for the Download to Finish
Check the task in your browser’s Downloads list. The file should have a
.apkextension. If it is still downloading or shows an error, finish or retry the download before opening it. -
Allow Installs from This Source
If the system says this source cannot install apps when you open the file, tap Settings in the prompt and enable Allow from this source. This setting applies only to the app you are using as the source.
-
Return to the Installer
Use the system Back action to return to the installation screen. Confirm the app is named Shadowrocket, then tap Install. If the installer has closed, reopen the APK from the same browser’s download list.
-
Open the App for the First Time
When installation finishes, tap Open or launch Shadowrocket from the system app list. Once the app opens, you can return to the source permissions page and turn off the temporary install permission.
Permission to install apps from a source is separate from VPN connection permission. The first controls whether a browser or file manager can start an installation. Android asks separately when the app starts a system VPN connection. Allowing installation does not automatically approve a later connection request.
3. Fix Downloads That Do Nothing in WeChat
Downloads may work differently in WeChat’s built-in browser than in your system browser. If tapping Download produces no file, leaves you on the same page, or shows a restriction, switch the browser rather than tapping repeatedly. Start troubleshooting the installation only after the file appears as complete in the browser’s download list.
- Open the menu in the upper-right corner of the current WeChat page and look for Open in Browser or a similarly named option. The wording may vary between devices and WeChat versions.
- If that option is missing, tap Copy Link, switch to your system browser, and paste the address into the address bar. Make sure the address is on
shadowrocket9.com, then open the download page. - In your system browser, tap the Android arm64 download option again and check the browser’s own download list for progress. Tapping a link in WeChat may not create a download task that can continue in your browser.
- After the download finishes, open the APK in the same browser. If the system asks for installation permission, grant it to that browser instead of looking for a setting in WeChat.
4. Allow Unknown App Installs: Which App Needs Permission?
On Android, “unknown apps” refers to the installation source, not an assessment of the app’s features. Permissions are managed separately for each source app. If you open the APK in a browser, check the browser’s permission; if you open it from a file manager instead, Android may check that app’s permission. If an install is still blocked after you enabled permission, first verify which source app the system identifies.
Check System Settings
- Common path
- Settings → Apps → Special app access → Install unknown apps
- Select
- The browser or file manager used to open the APK
- Permission toggle
- Allow from this source
- Can’t find the setting
- Search Settings for “Install unknown apps,” or use the settings link on the installation warning screen
Manufacturers may change the settings layout. Follow the path and source name shown on your device.
Check the Installation Status
- Still blocked after allowing permission
- Check that the source app shown in the warning is the same app you just allowed
- Nothing happens after returning
- Reopen the completed APK from the original browser’s download list
- Can’t change the toggle
- Check whether the device is managed or restricted by a work profile or parental controls
- Installation complete
- You can turn off the temporary install permission and keep Shadowrocket installed
Turning off permission to install from a source does not uninstall the app or replace system VPN permission controls.
On a device managed by an employer or school, an administrator may control these settings. Contact the device administrator to confirm whether installation is allowed. Do not try to bypass a policy by repeatedly clearing system settings or disabling other security features. Read any security warning carefully to determine whether it concerns an unapproved source, an incompatible file, or a management restriction.
5. First Launch and Checks Before Connecting
If Shadowrocket opens, installation is complete. Next, add your existing configuration in Home. Use Config to manage rule configurations and Settings to change app preferences. Button locations may differ in the current Android version; do not assume they match the layout on other platforms.
- Import existing details: In Home, choose the appropriate option from the add menu. To import a subscription, select the Subscribe type, paste your full URL, and save it. The example
https://example.com/sub?token=xxxxis for formatting only and cannot connect. - Check the imported content: Make sure the expected entries appear in the list, then select one that works. A subscription URL is not a single server address and should not be entered in a server address field.
- Approve the VPN request: The first time you connect, read Android’s VPN connection request. Confirm that Shadowrocket is the app requesting access, then approve it. If you denied the request earlier, start the connection again from the app.
- Test manually first: During initial setup, connect and disconnect manually to check basic access. Configure automatic connections later, so an automatic trigger is not mistaken for an installation problem.
The Global Routing mode affects how traffic is handled after connection. These are three commonly used modes in Shadowrocket. Choosing Proxy will not fix incorrect server settings; choosing Config requires a working set of rules and policies in the active configuration.
Config
RecommendedUses the rules in the active configuration to select a policy. This does not mean all unmatched traffic goes direct; traffic that matches no earlier rule is handled according to settings such as FINAL.
Best for: Using a verified rule configuration to route traffic by rule day to day
Proxy
Uses the proxy mode for all traffic handled by the app. This can temporarily rule out rule-based routing as a factor during testing, but the selected connection and your network must still be working.
Best for: Short-term troubleshooting to see whether rule selection is causing the issue
Direct
Uses a direct connection for traffic handled by the app. This does not test whether a proxy server works. A system VPN connection indicator does not mean a request is going through a proxy server.
Best for: Comparing access over your current network without a proxy
6. Common Installation and First-Use Questions
Start by noting the full error message, then troubleshoot the stage where it occurs. If installation is not complete, there is no need to change protocol settings or rules. If the app opens but a particular website does not, reinstalling is not the first step. Narrow the issue down to downloading, installing, opening, or connecting to avoid repeating steps unnecessarily.
“There was a problem parsing the package.” What should I do?
First check whether the browser says the download is complete. Delete incomplete or duplicate failed files, then download the APK again from our download page. If the same message appears, note your Android version and device architecture, then check the package compatibility information. Renaming the file or repeatedly changing permissions will not fix a file parsing error.
Why does Android ask for permission again after I allowed my browser?
Check the source name in the system prompt. If you switched to a file manager to open the APK, the source has changed from the browser to the file manager. You can reopen the file from the original browser’s Downloads list or grant permission to the source app you are actually using, then turn it off after installation.
“App not installed.” Should I delete the old app first?
Do not delete an existing app as the first step. Check available storage, device compatibility, and whether Android reports a package conflict. If Shadowrocket is already installed, save your configuration using the app’s backup or export feature before deciding what to do next. Uninstalling may erase local data and should not be your first step.
The app opens, but the connection fails. Did installation go wrong?
If you can open Home, installation is usually complete. Check that you imported your own configuration, selected an entry, and approved the system VPN request. Then check the Global Routing mode and server settings. An empty list or incorrect credentials do not mean the APK failed to install.
The download is complete. Do I need to keep the APK?
Once you confirm the app is installed and working, you can delete the downloaded file from your browser’s download list or file manager to free up storage. Deleting the APK does not uninstall the app. To download it again, return to our download page. Before installing an update, save important configuration and read the system’s update prompt.
How to Get Shadowrocket
The iPhone and iPad version is a one-time $2.99 purchase on the App Store. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. Visit the download page for platform-specific instructions, then see the tutorials for help with initial setup.
Go to Downloads View the Guide