For anyone installing Shadowrocket on a Mac or Windows PC for the first time. On the Mac you’ll use, check the “Chip” or “Processor” field, then choose the matching DMG. If the app is blocked on first launch, distinguish a standard security prompt from a signature issue or device-management restriction. Only consider proceeding if you can verify the source and publisher and macOS still offers a one-time confirmation option.
Choose Apple Silicon or Intel for Mac
On the Mac you’re installing to, open the Apple menu → About This Mac. If you see a Chip field with a name such as Apple M1 or Apple M2, choose the Apple Silicon version. If you see a Processor field with Intel in the name, choose the Intel version. Don’t guess based on the model name—MacBook Pro and Mac mini models, for example, can use either architecture. If you download the installer on another computer, choose the version for the target Mac.
Choose the DMG based on About This Mac
Apple Silicon
- If Chip shows an Apple M-series chip, choose the Apple Silicon version for Mac on the downloads for all platforms page.
- If you see a Rosetta prompt during installation, first check that you selected the right download and are opening the intended copy. Installing Rosetta is not a substitute for checking.
Intel
- If Processor shows a model such as Intel Core, choose the Intel version for Mac on the downloads for all platforms page.
- The Intel version for Mac is still a macOS app. Don’t download the Windows installer just because it also mentions an Intel processor.
The chip determines which installer to choose; check the macOS version requirements separately.
When the download finishes, open the DMG from Downloads in Finder. If the disk image shows Shadowrocket and an Applications shortcut, drag the app to Applications. Once copying is complete, eject the disk image and launch the app from Applications for the first time. Don’t keep launching the copy inside the disk image. If an app with the same name is already installed, confirm whether it’s the old copy you want to keep or the one you intend to replace, so you don’t keep opening the wrong file. If the prompt appears before the DMG mounts, make sure the download has finished, then get it again from the downloads page; you haven’t reached the app’s first-launch steps yet.
macOS says it “cannot verify the developer”: When to use Open Anyway
Gatekeeper checks apps downloaded from the internet. “Cannot verify the developer” means macOS couldn’t complete the required verification; it doesn’t mean the file has been identified as malicious, nor does it prove the file is safe. Check the download record and source. If you can’t verify the publisher or have reason to suspect the file was replaced, stop here. An app icon, filename, or webpage claim is not proof of who published it.
Confirm which app was blocked
In Finder → Applications, open the copy of Shadowrocket you just moved and check the app name in the prompt. Don’t follow the steps below if the actual message says the macOS version is incompatible, the app is damaged, or malware was detected.
Open Privacy settings
Dismiss the prompt, then open the Apple menu → System Settings → Privacy & Security and scroll down to Security. On older macOS versions, check System Preferences → Security & Privacy → General. It’s best to check right after the block occurs.
Check for the one-time option
Choose Open Anyway next to the app only after you’ve verified the source and publisher and confirmed that the prompt refers to the app you just opened. The system may ask you to authenticate with administrator credentials or Touch ID. In the dialog that follows, check the app name again and choose Open.
Check that the app launches
Confirm that Shadowrocket opens from Applications. If the same prompt appears again, check whether you launched a different copy. If Open Anyway isn’t available or the device is managed by an organization, ask the device administrator for help; don’t change global security settings.
Allowing the app to launch for the first time and authorizing a VPN configuration are separate steps. The first lets a specific app open; the system prompts for the second when a connection needs to be established. To check that installation is complete, just open the app—you don’t need to import a configuration or authorize a connection at the same time.
Windows SmartScreen block: Check the digital signature first
If a “Windows protected your PC” message appears when you open the installer, don’t choose an option to proceed yet. A Microsoft Defender SmartScreen reputation warning is different from a specific threat detection. Before proceeding, make sure the file came from the expected download page, its signature is valid, and the publisher matches what you expect. A familiar filename or icon isn’t enough.
- Close the warning. In File Explorer, find the installer you just downloaded, right-click it, and choose Properties → Digital Signatures. Select the signature and open Details. Check that Windows reports “This digital signature is OK,” then verify that the signer is the expected publisher. Don’t mistake the certificate authority’s name for the software publisher.
- If there’s no Digital Signatures tab, the signature is invalid, the signer doesn’t match, or you can’t verify the expected publisher, don’t run the installer. Get it again from the downloads for all platforms page. If the problem persists, give support the filename and exact warning text so they can check it.
- Only if your checks pass, the warning is solely a SmartScreen reputation block, and device policy allows it, choose More info when the window appears again. Verify the file and publisher shown, then choose Run anyway. If the only option is to exit or a threat has been detected, stop. Don’t disable system protection.
- If User Account Control appears next, the installer is requesting elevated permissions; this doesn’t mean SmartScreen approved the installation. Before continuing, check the program name and publisher in the dialog. If approval from your organization’s administrator is required, follow your organization’s installation process.
After first launch: Installation complete or routing configured?
If the Shadowrocket main screen opens, you can finish checking the installation. To test your connection, go to Home and check Global Routing. The two modes below are for comparing a direct-connection baseline with rule-based routing. Neither can fix the wrong installer architecture or a system block, or replace a valid configuration.
Config
RecommendedRouting follows the rules in the currently selected configuration. Before connecting, check the active configuration in Config. A destination connecting directly doesn’t mean the rules aren’t working; the request may match DIRECT.
Best for: checking everyday routing with a valid configuration
Direct
Connect traffic handled by Shadowrocket directly, without using a proxy route. For a comparison, visit the same address that you’ve confirmed is reachable directly. If it works with Direct but not with Config, check the configuration rules and selected route.
Best for: briefly establishing a direct-connection baseline, then restoring your previous settings
Common first-install questions
Installed the wrong chip version? Why won’t it open after downloading again?
Quit the old copy, then open the newly copied Shadowrocket from Finder → Applications instead of using an old Dock shortcut. Use Get Info in Finder to check the location and application type fields, if available. If the message still says you need a newer version of macOS, changing the architecture won’t resolve the system-version requirement.
If macOS says the app is “damaged,” should I use Open Anyway?
Don’t treat this as a standard developer-verification prompt. Quit the app and remove the newly copied app and its DMG. Download it again from the downloads page and copy it again. If the same message appears, note its exact wording, your macOS version, and your Mac’s architecture, then ask support to check. Don’t try to modify the file or system security settings.
The Windows prompt only shows “Don’t run.” What should I do?
If More info is available, expand it and check the details. If Run anyway still isn’t available, or the system says an organization’s policy blocked the installation, don’t continue. Give your administrator the installer’s filename, signer, and full warning so they can identify whether it’s a reputation warning, an application-control policy, or a permissions restriction.
The main screen opens on my Mac, but why isn’t it connecting?
Opening the app doesn’t start a connection. Check the connection status in Home. If you haven’t imported your own valid configuration, follow the usage guide to import it, check Global Routing, then respond to the system’s connection authorization prompt. Don’t treat a connection issue as an installation block or repeat the allow steps.