Installing Shadowrocket on Mac or Windows for the first time? Check the operating system and processor on the computer where you’ll run the app, then choose the matching package on the Download & Install page. Only consider allowing a specific file to open once if you’ve confirmed its source, identified the warning, and your device’s policies permit it. Architecture mismatches, damaged files, detected threats, and organization restrictions require different solutions—not an override.
01 Check your Mac chip and Windows system type
Choose the Apple Silicon or Intel Mac package based on the processor, not the MacBook or iMac model name. On Windows, check both the system type and processor architecture; “64-bit” alone isn’t enough. If you download the installer on another device, check these details on the computer where you plan to install it.
Mac package
- Where to check
- Apple menu → About This Mac
- Chip shows an Apple M-series processor
- Choose the Apple Silicon version (arm64) on the Mac platform card
- Processor shows Intel
- Choose the Intel version (x64) on the Mac platform card
Use the Chip or Processor field as shown; don’t infer the processor from the purchase year.
Windows package
- Where to check
- Settings → System → About
- Field to check
- Under Device specifications, check System type
- How to choose
- Compare the Windows system type and processor architecture with the requirements listed on the Windows platform card
Both x64 and ARM64 are 64-bit. Check the package’s supported architectures; bitness alone doesn’t determine compatibility.
02 Download and launch the installer for your platform
Go to the Download & Install page and choose the card for your platform. Once the download is complete, find the saved file in Finder or File Explorer. If the folder contains multiple copies with the same name, use your browser’s download history to locate this download and open its folder, so you don’t accidentally use an older package.
Installation steps for Mac and Windows
Mac: Identify the disk image or installer
- If you downloaded a
.dmgfile, double-click it to mount the disk image. If the window shows an app icon and an Applications shortcut, follow its instructions to copy the app to Applications. - If you downloaded a
.pkgfile, open it and follow the Installer prompts. Dragging it to Applications is not a substitute for running the installer. - After installation, open the app from Finder → Applications. Don’t use the disk image window as your regular launch location.
Windows: Check the file type before running it
- If you downloaded an archive, use Extract All in File Explorer, then open the installer from the extracted folder.
- If you downloaded a
.exeor.msiinstaller, open it and follow the on-screen instructions. If User Account Control appears, check which program is requesting permission and review its publisher information first. - After installation, search for Shadowrocket from Start and launch it. Opening the downloaded file again only reruns the installer; it doesn’t launch the app.
Follow the steps for the file type you downloaded. If you see an incompatibility warning before installation, return to the platform card and check the system requirements and architecture.
03 macOS can’t verify the developer: When to use Open Anyway
When you first open a downloaded app or installer, macOS may say it can’t verify the developer. Consider using Open Anyway only if you’ve confirmed the file came directly from this site’s Download & Install page, the warning specifically says the developer can’t be verified, and your device allows you to approve it. If macOS says the app is damaged or will harm your computer, don’t continue with these steps.
Confirm which item is affected
Dismiss the warning and check whether it refers to the Installer package or Shadowrocket already copied to Applications. Only handle the same item you just opened; don’t approve other files in your Downloads folder.
Verify the source
Compare the browser’s download history with the file’s saved location. If the file came from a forwarded message or shared folder, or you can’t identify which download it belongs to, stop and choose the correct architecture on the Download & Install page.
Open System Settings
After attempting to open the app and having it blocked, go to Apple menu → System Settings → Privacy & Security. Check the Security section for a prompt about the item you just opened and
Open Anyway.Approve once
Check which app or installer the prompt refers to, select
Open Anyway, verify your identity if requested, then confirm in the next dialog. If the option isn’t available, don’t change global security settings. Ask your administrator to handle managed devices.
04 Windows SmartScreen: Distinguish reputation warnings from threats
If the dialog is titled Windows protected your PC and says Microsoft Defender SmartScreen prevented an unrecognized app from starting, this is a reputation warning—not confirmation that malware was detected, nor proof that the file is safe. Consider allowing this run only if you’ve verified the download source and file details, and the dialog offers a way to continue.
- Check the file. In File Explorer, right-click the installer you just downloaded and open Properties. If there’s a Digital Signatures tab, select the signature and open Details to check its status and signer. If there’s no such tab, the filename is not proof of a signature. Don’t run the file if you can’t confirm its source or publisher.
- Review the warning details. In the SmartScreen dialog, select
More infoand check the app and publisher details. Only if they match your expectations, you’ve confirmed the source, andRun anywayis available should you select it for this file. - Distinguish the next prompt. Continuing may bring up User Account Control. It asks whether to let a program make changes to your device; it isn’t SmartScreen’s approval. Cancel if the program name or publisher doesn’t match what you saw in the previous step.
- Know when to stop. Stop the installation if Windows Security reports a threat, the file has been quarantined, or the message says your organization’s policy blocked it. If
Run anywayisn’t available, these one-time approval steps don’t apply. Don’t disable SmartScreen or real-time protection to proceed.
05 Troubleshoot installation and first launch issues
My Mac says the app is damaged. Is that the same as an unverified developer warning?
No. Stop trying to open it, make sure the browser finished downloading the file, and check the architecture in About This Mac. If the disk image won’t open or an error occurs while copying, download the package again from the Download & Install page. If the new file still fails, note the full error and whether it occurred while mounting, copying, or launching. Don’t treat it as a developer verification warning.
Windows says “This app can’t run on your PC.” What should I do?
This isn’t a SmartScreen reputation warning. Go to Settings → System → About and note the System type, then check that you downloaded the Windows package and meet its system requirements. If your device’s architecture isn’t supported, rerunning the same file or elevating permissions won’t make it compatible.
Shadowrocket opens, but I haven’t connected yet. Is it installed?
If Shadowrocket launches normally from Applications or Start, the app is running on your computer. Establishing a connection is a separate step that requires service details or a subscription you already have. Follow the setup guide to import them, then troubleshoot the connection. An unconfigured connection doesn’t mean installation failed, and repeatedly approving the installer won’t connect you.
Get Shadowrocket and set it up after installation
Get Shadowrocket for iPhone and iPad from 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; choose an installer from this site’s Download & Install page.