For Apple Silicon Macs, Intel Macs, and Windows PCs. On Mac, choose a download based on the chip or processor shown in About This Mac. On Windows, check the device architecture under System type. For first-launch warnings, distinguish reputation alerts from file corruption and device policy blocks. Use a system-provided option to allow a single file only after verifying its source and confirming that device policy permits it.
Choose an installer by checking your system’s architecture
The same Mac model name can span several chip generations, so don’t rely on its appearance or purchase year. On Windows, “64-bit operating system” alone isn’t enough to choose a package: both x64 and ARM devices can be listed as 64-bit. Check the architecture shown on the computer, then consult the downloads for all platforms to find the matching option.
Mac: Check “Chip” or “Processor”
- Where to check
- Apple menu → About This Mac
- Apple M-series chip shown
- Choose the Apple Silicon version
.dmg. - Intel processor shown
- Choose the Intel version
.dmg.
Check the Mac you’re installing on. If you download the file using another computer, don’t choose a package based on that computer’s chip.
Windows: Check “System type”
- Where to check
- Settings → System → About
- Field to check
- Under Device specifications, check System type.
- Match the installer
- Check the download page for x64, ARM, or 32-bit compatibility. If a platform isn’t listed, don’t assume it’s supported.
“This app can’t run on your PC” isn’t a SmartScreen reputation warning. Check the architecture and system compatibility first.
Install on Mac: Copy the app and handle first-launch warnings
Choose the right installer
On the download guide, choose the Apple Silicon or Intel version. Wait for the browser to confirm the download is complete, then open the
.dmgfrom Finder → Downloads. This helps avoid mistaking an incomplete download for a corrupted installer.Copy to Applications
In the mounted disk image window, drag Shadowrocket to Applications. Wait for Finder to finish copying, then open the copy from Applications. The disk image is just the installer—you don’t need to launch the app from it each time.
Check the exact warning
If the only prompt asks whether to open an app downloaded from the internet, confirm the file came from the download guide and select Open. If you see “developer cannot be verified,” close the prompt first. If macOS says the app is damaged, could harm your computer, or is blocked by an organization’s policy, stop. These aren’t ordinary reputation warnings.
Allow this app only
Only proceed if you’ve verified the file’s source and the warning is one that can be handled on a personal device. After attempting to open the app, go to System Settings → Privacy & Security. Under Security, find the Open Anyway option for Shadowrocket, select it, and authenticate if prompted. Select Open in the confirmation dialog. On older versions of macOS, look for the option under System Preferences → Security & Privacy → General.
Open Anyway usually appears for a limited time after an attempted launch; macOS generally keeps it available for about an hour. If you can’t find the option, note the exact warning, make sure you’re opening the copy in Applications, and check whether the device is managed. Don’t disable system-wide protections to make the button appear.
Install on Windows: Tell SmartScreen warnings from permission prompts
Get the Windows installer from the download guide and wait for it to finish downloading before opening it from its folder. If the dialog says “Windows protected your PC,” check whether it’s a Microsoft Defender SmartScreen reputation warning for an unrecognized app. This is different from a Microsoft Defender threat detection or an administrator blocking the installation.
- Check your download history first. Find the file you just downloaded from the download guide in your browser’s download history. Don’t open a different file with the same name from an unknown source. If the file’s Properties has a Digital Signatures tab, open Details to check the signature status. Stop the installation if the signature is invalid or the publisher doesn’t match verifiable information.
- Proceed only with a verified reputation warning. In the SmartScreen window, select More info and check the app name and publisher. Select Run anyway only if you can verify the file’s source and identity, there’s no threat alert, and your device allows installation. If the option doesn’t appear or you can’t verify the publisher, don’t proceed.
- Handle permission requests separately. If User Account Control appears next, it’s asking whether the program can make changes to your device; it does not verify the file’s safety. Check that the request comes from the installer you just launched. If administrator credentials are required and you don’t have them, exit and contact your administrator.
What to do on personal and managed computers
Personal computer
- Use the exact warning text to tell security alerts, compatibility errors, and permission requests apart. Don’t judge by the dialog’s color.
- Use system-provided options only for the specific app or installer you’ve verified. Leave protections for other apps at their defaults.
Work or school computer
- If you see an organization restriction or administrator block, or the installation option is unavailable, note the system type, file name, and exact warning.
- Give the administrator the download guide URL and warning details, then follow your organization’s software approval process.
Allowing one file doesn’t change the security policy for the whole computer. Treat threat alerts and organization blocks differently from reputation warnings.
First launch: From Home to Global Routing
Launch Shadowrocket from Applications on Mac or from its entry in the Windows Start menu. If Home opens, the app is running, but that doesn’t mean an existing configuration can connect. With the connection off, open a website you can normally access and note whether your network is working. Then compare the results using a configuration you already have. If you haven’t imported a configuration yet, see Quick Start. Missing connection details don’t mean the installation failed.
Config
RecommendedOn Home, set Global Routing to Config to route traffic according to the current configuration’s rules. Before testing, go to Config and check which configuration file is active. If no earlier rule matches, check the policy for FINAL; don’t assume unmatched traffic goes direct.
Best for: Checking that everyday rule-based routing works as expected after you’ve added a configuration
Direct
Temporarily set Global Routing to Direct to send traffic handled by the client directly. Compare the same website with the Config result. If it opens in Direct but not in Config, first check the active rules and the policy they match. Restore your previous setting when you’re done.
Best for: Telling direct-connection issues from rule-based routing issues when the app opens
Common issues: Corruption, blocks, and repeated warnings
Mac says “is damaged and can’t be opened.” Can I choose Open Anyway?
Don’t treat this like an ordinary “developer cannot be verified” warning. Close the dialog and remove the installer from this download and the new copy you just made, while keeping any previously working app and configuration. Download the package for the correct chip from the download guide again, wait for it to finish, and reinstall. If the new copy shows the same error, note your macOS version and the exact warning, then check the FAQ. Don’t keep trying to bypass the warning.
Why is there no “Run anyway” button on Windows?
First confirm that the dialog is from SmartScreen and check whether More info is available. If the warning comes from organization policy, threat detection, or app control—or there’s still no button after expanding the details—then the single-file option described here isn’t available. Contact an administrator for managed computers. On a personal computer, stop if you receive a threat alert.
Why does my Mac show a warning again when I click the Dock icon?
Quit the app and eject the disk image, then open Shadowrocket directly from Finder → Applications. If it launches normally there, but the old Dock icon doesn’t work or asks you to mount the disk image again, remove the old shortcut and drag the app from Applications to the Dock again. If the app also shows repeated errors when opened from Applications, note the warning and don’t keep confirming prompts for an unverified copy.
Home opens, but webpages stop loading as soon as I connect. Should I reinstall?
Disconnect, then open the same webpage in the same browser. If it still won’t load, troubleshoot your current network first. If it loads again, check Global Routing on Home and the active configuration in Config, then compare with Direct. This makes it easier to distinguish network issues from configuration issues than reinstalling does.