At a glance

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.

2 options
Mac installers: Apple silicon (arm64) and Intel (x86-64)
2 items
Before installing on Windows: note System type and Version under Windows specifications

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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

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.