This guide covers Apple Silicon Macs, Intel Macs, and 64-bit Windows PCs that meet the download page’s compatibility requirements. Check the system information to identify your device’s architecture, then choose the matching installer from our download page. If a warning appears on first launch, distinguish a developer verification warning from an incompatible architecture or an explicit security block. Proceed only after confirming the file’s source and if the system allows you to approve the app individually.
1. Check your system architecture and choose the installer
Check the system information on the computer where you’ll install the app. If you download the installer on a phone for later use on a computer, choose based on the computer’s processor—not the device detected by your browser. Both Mac installers use the .dmg extension, so the extension alone won’t tell them apart.
macOS: Check About This Mac
- Where to look
- Apple menu → About This Mac
- “Chip” shows an Apple M-series chip
- Choose the Apple Silicon Mac
.dmg - “Processor” shows Intel
- Choose the Intel Mac
.dmg - Install location
- Finder → Applications
Product names such as MacBook and iMac don’t indicate the processor. Check the information shown in About This Mac.
Windows: Check System type
- Where to look
- Settings → System → About → System type
- 64-bit operating system, x64-based processor
- Check the download page’s compatibility requirements, then choose the 64-bit Windows
.exe - ARM-based processor
- Check that the download page explicitly supports your device. Don’t assume compatibility just because the system is 64-bit.
- 32-bit operating system
- Can’t run a 64-bit installer, even if the processor itself supports 64-bit
System type shows both the operating system’s bitness and the processor architecture. Check both.
2. Install on Mac and handle first-launch warnings
A .dmg is a disk image. Double-clicking it mounts the image as a new volume in Finder; the app hasn’t yet been copied to Applications. After installation, launch the app from its installed location to avoid confusing the copy in the disk image with the one in Applications.
Download the matching installer
Open the Mac section of the download page, then choose Apple Silicon or Intel based on About This Mac. Once the download finishes, open the
.dmgyou just saved in Finder’s Downloads folder.Copy to Applications
Drag Shadowrocket from the disk image into Applications and wait for the copy to finish. If macOS says an item with the same name already exists, check whether the app is already installed. If you simply opened a different disk image by mistake, don’t replace the existing app.
Launch the installed copy
Open Finder → Applications → Shadowrocket. If macOS only asks whether to open an app downloaded from the internet, check its name and source, then follow the prompt. If you see “Apple could not verify the developer,” close the alert first, then confirm that the installed copy came from the matching installer selected on our download page.
Check for an option to approve this app
Once you’ve confirmed the source and there’s no malware warning, open Apple menu → System Settings → Privacy & Security. Under Security, look for “Open Anyway” for Shadowrocket. If the button is available, click it, authenticate as prompted, then confirm that you want to open the app. This approval applies to the app only; there’s no need to disable app verification system-wide.
3. Tell apart SmartScreen and permission prompts on Windows
Once the download finishes, open the .exe you just saved in File Explorer’s Downloads folder. Microsoft Defender SmartScreen’s “Windows protected your PC” warning and User Account Control are separate dialogs: the first may appear before the installer runs, while the second asks whether to allow the program to make changes to your device.
Respond based on the warning shown
SmartScreen: Verify the file’s source
- Check your browser’s download history to confirm the file came from our download page. Then make sure the prompt refers to the file you just downloaded, not an older copy in the folder.
- If the warning only says the app is unrecognized, click “More info” to check the app name and listed publisher. If the file has a Digital Signatures tab in Properties, you can also review the signature details and status. Stop the installation if the information doesn’t match or you can’t confirm the file’s source.
- If you’ve confirmed the file, there’s no explicit threat warning, and Windows offers “Run anyway,” you can choose it for this launch only. If that option isn’t available, don’t disable SmartScreen to continue.
User Account Control: Check the permission request
- If the installer then requests elevated permissions, check the program name and publisher shown in the dialog, and confirm that it’s the installation you just started.
- Choose “No” if the name doesn’t match, the dialog appeared even though you didn’t start the installer, or the publisher differs from what you previously verified. Then check your download history and the file’s properties.
- If Windows asks for administrator credentials and you don’t have them, cancel the installation. On a work or school device, ask an administrator for approval instead of bypassing organizational policies.
Being able to click “Run anyway” doesn’t confirm the file’s source. If security software explicitly detects a threat, don’t run the app.
4. Common first-install problems
A prohibited symbol appears when I open the Mac app. Did I choose the wrong installer?
Go to Apple menu → About This Mac and compare the processor with the installer you selected. If you chose the right installer, check whether your macOS version meets the download page’s system requirements. A prohibited symbol isn’t a developer verification alert, and approving the app under Privacy & Security won’t fix an architecture or system compatibility issue.
Why isn’t “Open Anyway” showing under Privacy & Security?
Make sure you launched Shadowrocket from Applications, rather than just opening the .dmg. If the warning says “Apple could not verify the developer” and you’ve confirmed the source, try opening the app again, then immediately check Privacy & Security. If there’s no matching button, follow the system’s guidance and your device management policy.
Windows says “This app can’t run on your PC.” What should I do?
Go to Settings → System → About and note the bitness and processor architecture under System type. Compare both with the download page’s requirements. If they match, check that your browser shows the download as complete and, if needed, download it again from the page. This warning is different from a SmartScreen reputation warning; approving permissions won’t make an incompatible program run.
Shadowrocket opens, but I can’t connect. Did the installation fail?
If you can launch the app from Applications on Mac or the Start menu on Windows, installation and first launch are complete. Next, go to Home, check that you’ve added your own service configuration and selected an available entry, then follow the usage guide to check the connection switch and Global Routing. You don’t need to run the installer again.
Download and set up Shadowrocket
Two ways to get Shadowrocket: The iPhone and iPad version is available on the App Store for a one-time payment of $2.99; check the App Store listing for system requirements. The Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free, with installers available from our download page.