When installing Shadowrocket on Mac or Windows for the first time, choose the right installer and follow the exact system prompt. On Mac, one-time approval is in Privacy & Security; on Windows, if SmartScreen allows you to proceed, use the option in its dialog. First-launch approval will not fix an architecture mismatch, a detected threat, or an organization policy block.
Choosing a Mac version: check Chip or Processor
Open the Apple menu in the top-left corner of the screen and select About This Mac. Use the information shown on the Mac you’re installing on—not its purchase year, appearance, or a browser recommendation. If you download the installer on one computer to install on another, check the destination Mac’s details first.
Which Mac installer matches your chip?
Apple silicon
- About This Mac shows Chip with an Apple M-series value, such as Apple M1 or Apple M2.
- On the download page, choose the Mac version for Apple silicon. Even if this Mac can run some Intel apps, choose the installer that matches its chip.
Intel
- About This Mac shows Processor with an Intel value, such as Intel Core i5.
- Choose the Intel version on the same download page. Approval prompts cannot convert the Apple silicon version into an Intel version.
Both Mac downloads are .dmg files. The extension means the file is a disk image; it does not indicate which chip it supports.
Installing on macOS: Copy the app, then handle Gatekeeper prompts
Copy the app to Applications first, then open it from that folder. This prevents you from mistaking the copy inside the disk image for an installed app. Consider the system’s one-time approval only when the source is clear, the installer matches your chip, and the warning says the developer cannot be verified or Apple cannot check the app.
Open the disk image
Get the matching Mac installer from the download page. Once the download finishes, go to Finder → Downloads and double-click the
.dmgfile. If the disk image won’t mount, make sure the download is complete and download it again from the same source. The app inside the image has not been opened yet.Copy the app
Drag Shadowrocket from the disk image window to Applications. When copying is complete, eject the disk image from the Finder sidebar, then open the copied app from Finder → Applications.
Read the exact warning
If a dialog says the developer cannot be verified, close it and confirm that you’re opening the copy downloaded from this site and placed in Applications. If the system explicitly reports malware, says the app will damage your computer, or says the app is damaged, stop. Follow the instructions for that specific warning; don’t treat it as a routine verification prompt.
Approve the app
On recent versions of macOS, open the Apple menu → System Settings → Privacy & Security, then scroll to Security. If Shadowrocket is listed as the app that was blocked and Open Anyway is available, select it, authenticate if prompted, then choose Open in the confirmation dialog. On older systems, go to System Preferences → Security & Privacy → General.
Installing on Windows: Tell SmartScreen prompts apart from system blocks
Choose the Windows option on the download page. Once the download finishes, open the installer from File Explorer → Downloads. Read the dialog title and message first: a SmartScreen reputation warning, a User Account Control permission request, and a Windows Security threat detection are three different checks. Don’t assume that confirming one means the other two have passed.
SmartScreen reputation warning
- Identify the message
- Windows protected your PC appears with a message that SmartScreen blocked an unrecognized app from starting.
- Check the file
- Select More info and check the filename and publisher shown in the dialog. A matching filename alone doesn’t verify the source. Stop if you’re unsure about the source or publisher.
- When to proceed
- Proceed in this dialog only if you’re sure the installer came from the download page and Run anyway is available.
This option appears in the prompt for the current file. You don’t need to turn off protection globally in Reputation-based protection settings.
Threat detection and policy blocks
- Check detection history
- Open Windows Security → Virus & threat protection → Protection history. Check the time and filename to see whether the latest action relates to this installer.
- If a threat is detected
- If the file has been quarantined or removed, note the detection name and affected file. Don’t restore it from history to continue the installation.
- Organization restrictions
- If a message says an administrator blocked the app, or a managed device offers no option to continue, share the exact message with your device administrator for review.
If Run anyway isn’t available, don’t change system security policies as a workaround.
If a User Account Control prompt appears next, check that it’s requesting permission for the installer you just launched. This prompt asks whether the app can make changes to your device; it doesn’t confirm compatibility or replace the earlier source check.
Installation troubleshooting: Find the issue by when it occurs
Mac says the app isn’t supported. Should I look for Open Anyway?
Don’t start by looking for an approval button. Return to About This Mac, note the chip and macOS details, and check them against the version you chose. If you downloaded the wrong installer, quit the app, remove only the incorrect copy you just placed in Applications, and install using the matching disk image. If the installer is correct but the error persists, keep the exact warning and check system compatibility.
Why can’t I find Open Anyway in Privacy & Security?
First, confirm that you launched this copy from Applications and that the warning was specifically about an unverified developer or Apple being unable to check the app. This button isn’t a permanent setting. If you simply dismissed the warning earlier, reopen the same app after verifying its source, then return to Security and check again. If there’s still no approval option, check whether the Mac is managed or the app was blocked for another reason.
Windows says “This app can’t run on your PC.” What should I do?
This isn’t a Windows protected your PC reputation warning. Go to Settings → System → About, note the System type, make sure you have the Windows installer, and confirm the browser finished downloading it. If downloading again from the same source doesn’t fix the error, keep the System type and full error message for troubleshooting. Don’t change SmartScreen settings.
The app opens after installation, but won’t connect. Should I reinstall it?
If the app opens, the issue is no longer with the installer’s first-launch stage. Follow the setup guide to check that your configuration has been imported and the connection switch is on, then verify that Global Routing is set as expected. Re-approving the installer won’t change the app’s routing settings.