For your first Shadowrocket installation on Mac or Windows, check the system information to identify your processor, then choose the matching installer from this site’s download page. If the first launch is blocked, distinguish a source-verification warning from a damaged file or a device-management restriction. Allow an exception for that specific file only when you have confirmed its source, the system offers that option, and your device’s policies permit it.
How to check your Mac chip and Windows system type
On a Mac, open Apple menu → About This Mac. If you see Chip with a value such as Apple M1 or M2, choose the Apple silicon version. If you see Processor with a value such as Intel Core, choose the Intel version. Use the field and its value—not the computer’s appearance, screen size, or purchase year. The same Mac product line may include both architectures.
On Windows 10 and Windows 11, go to Start → Settings → System → About and check System type. For example, 64-bit operating system, x64-based processor means both the operating system and processor use the x64 architecture. If you see ARM-based processor, don’t assume that “64-bit” means x64; check the download page for compatibility details. Dismissing a security warning won’t fix an unsupported system type or version.
Install Shadowrocket from the download page
Close any running installer first, and keep the file you just downloaded from this site separate from older copies. Files with the same name may be in different folders; if a system warning appears, first confirm that it was triggered by the file you just downloaded. Don’t get the installer from a chat attachment or an unverified file-sharing link.
Choose the right installer
Go to the download page. In the Mac section, choose Apple silicon or Intel; in the Windows section, check the listed system requirements. Even if Rosetta is installed, choose the Mac installer for your processor—you don’t need to use the Intel version just to keep using an older installer.
Wait for the download to finish
Check the browser’s Downloads list to make sure the transfer is complete, then open the folder containing the file. If the browser reports an interruption, the download is still in progress, or the file can’t be read, download it again from the download page. Don’t try to run it by changing its file extension.
Install on Mac
If you open a disk image and the window asks you to drag the app to Applications, do so and wait for the copy to finish. Then open Shadowrocket from Finder → Applications. Don’t keep launching it from the disk image. If a warning appears, confirm that it applies to the app copied to Applications.
Install on Windows
Open the downloaded installer in File Explorer and follow the on-screen steps. If a permission prompt appears, first confirm that it was triggered by the installer you just opened. If a managed device requires administrator approval, ask the device administrator; don’t change permissions to bypass the process.
Verify the first launch
On Mac, launch Shadowrocket from Finder → Applications. On Windows, search for Shadowrocket from Start and open it. If the main window stays open, installation and startup are complete. Proxy details, rules, and connection availability are part of later setup and don’t determine whether installation succeeded.
macOS can’t verify the developer: check for Open Anyway
If Gatekeeper blocks the app, read the full warning first. “Can’t verify the developer” is not the same as a warning that malware was detected. An “app is damaged” message shouldn’t be treated as a source-verification warning either. Use a system-provided exception for a specific launch attempt only if you can confirm the file came directly from this site’s download page, the installer matches your device, macOS hasn’t reported malware, and your device’s policies allow it.
- Try opening Shadowrocket from Finder → Applications. When the verification warning appears, cancel it. Make sure the app named in the warning matches the app you just opened.
- Then go to Apple menu → System Settings → Privacy & Security and scroll down to the Security section. If Open Anyway appears for Shadowrocket, select it, authenticate as prompted, then select Open in the confirmation dialog. On older macOS versions that still use System Preferences, go to System Preferences → Security & Privacy → General.
- If you don’t see Open Anyway, make sure you’re using the current copy, try opening it once more, then return to Settings right away. If the button still doesn’t appear, or the warning explicitly mentions malware, a damaged file, or a management restriction, stop. Don’t turn off Gatekeeper or change the file’s quarantine attribute.
Windows SmartScreen: distinguish reputation warnings from malware alerts
If the installer triggers Windows protected your PC, SmartScreen is checking the app. Read the warning carefully to see whether it’s only saying the app is unrecognized. A threat detected in Protection history and a block imposed by an administrator require different responses; don’t follow the same steps for both.
Choose what to do based on the Windows warning
App is unrecognized
- Select More info to check the file name and publisher, then compare them with the installer you downloaded and the publisher information you can verify.
- If you’ve confirmed the file came from this site’s download page, the warning concerns only the app’s reputation, and your device’s policies allow it, select Run anyway if that option is shown. If you can’t verify the source or the publisher information doesn’t match, don’t run the file.
Threat alert or policy block
- If Windows Security reports a detected threat, go to Windows Security → Virus & threat protection → Protection history and check the relevant entry and affected file. Don’t restore the file from quarantine.
- If a policy set by your organization blocks the app, or the only option shown is to cancel, keep the original warning and file name and ask your device administrator to review them.
Handle the warning for the current file only. Don’t turn off SmartScreen, real-time protection, or your organization’s device policies.
What to record if installation fails
First identify where the problem occurs: downloading the file, opening the installer, completing installation, or launching the app. A system warning that appears immediately after you double-click the installer is different from an app that opens and then quits. Recording the stage and the exact warning makes it easier to diagnose than simply saying it “won’t open.”
Mac troubleshooting notes
- System information
- The macOS version shown in About This Mac, plus the full value of Chip or Processor
- Installer selected
- Whether you selected Apple silicon or Intel on the download page
- Launch location
- Finder → Applications, or a disk image that’s still open
- Exact warning
- Distinguish “can’t verify the developer,” “is not compatible with this Mac,” and “app is damaged”
If the warning says the app is incompatible, check the chip and system requirements first. Open Anyway won’t change the binary architecture.
Windows troubleshooting notes
- System information
- System type and Version from Settings → System → About
- When the error occurred
- When double-clicking the installer, during installation, or when launching from Start
- Warning source
- SmartScreen, Windows Security, or an error dialog from the installer
- Error details
- Keep the full warning, including any error code
Before sharing troubleshooting details, hide your account name and personal folder paths. Don’t include subscription URLs or connection credentials.
Mac and Windows installation FAQs
Should I replace the Intel version after moving to an Apple silicon Mac?
We recommend switching to the Apple silicon version for your new device. Quit Shadowrocket first and keep your existing configuration if needed, then download the matching installer from the download page. After installation, open the app from Finder → Applications and make sure you’re launching the new copy, not an old shortcut pointing to a migrated app.
My Mac says the app is damaged. Can I use the developer verification steps?
Don’t treat these warnings as the same issue. Stop using the current copy, check your chip and system in About This Mac, then download a matching installer again from the download page. If the new copy shows the same error, keep the full warning and pause the installation.
Why isn’t Run anyway available after I select More info?
Not every block can be overridden by the user. If a warning mentions an organization policy, share its exact wording with your administrator. If the system reports a threat, check the entry in Protection history and don’t run the file. Don’t look for a way around the block by renaming the file, moving it to another folder, or turning off protection.
I keep seeing the same warning after downloading again. Could I be opening the old file?
Find the latest download in your browser’s Downloads list, then use Show in Finder or Show in folder to locate it. Check the folder, file name, and download completion time, then open the file from that location. If you copy it to Applications on Mac, make sure you open the copy after the transfer finishes.