Shadowrocket Desktop Install Guide: Mac Apple Silicon vs. Intel and Windows SmartScreen

Choose the right Mac installer for your chip, handle the “developer cannot be verified” warning, and learn what to do when Windows SmartScreen blocks the app.

In this guide

This guide is for anyone installing Shadowrocket on a Mac or Windows PC for the first time. First, check your processor architecture and choose the right download. Then handle macOS’s first-launch prompt or Windows SmartScreen, and finally check your configuration, Global Routing, and network connection. If your system explicitly reports malware, file corruption, or an organization policy restriction, stop and investigate instead of treating every warning the same way.

Before you install: Check your platform, chip, and download

Get Shadowrocket desktop installers from the Get the App page on this site. Mac downloads are available for Apple silicon and Intel. For Windows, use the installer listed in the Windows section; Android and Linux downloads are also available. Don’t apply mobile installation steps to a computer, and don’t identify your Mac’s processor by its appearance, purchase year, or browser.

There are two ways to get Shadowrocket: the iPhone / iPad version is available on the App Store for a one-time $2.99 purchase; the developer is Shadow Launch Technology Limited, and system requirements are as listed on the App Store page. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. Use this guide’s download links to reach the download page, which lists currently available files and platform details.

Before installing on Mac

Where to check
Apple menu → About This Mac
Chip field
If Chip shows an Apple chip, choose the Apple silicon version
Processor field
If Processor shows Intel, choose the Intel version
Installer
The DMG for your Mac’s architecture from the download page

Use the system information on the Mac you’re installing to—not the download history from another device.

Before installing on Windows

Where to check
Settings → System → About
Architecture
Device specifications → System type
Where to download
The Windows section of this site’s download page
Compatibility
Compare System type with the current details on the download page

Windows on ARM users should check the compatibility notes first. Don’t assume every Windows package runs natively.

Mac: Choose the Apple silicon or Intel version

Open the Apple menu in the top-left corner of your screen and select About This Mac. If you see a Chip field with an Apple chip name, choose the Apple silicon version on the download page. If you see Processor and Intel, choose the Intel version. The layout varies across macOS versions, but the processor type is what matters.

How to choose the right Mac version

Apple silicon
  • The Chip field in About This Mac shows an Apple chip.
  • On the download page, select the Mac Apple silicon download.
  • When a native version is available, choose the one that matches your Mac. Translation software is not part of choosing an installer.
Intel
  • The Processor field in About This Mac shows Intel.
  • On the download page, select the Mac Intel download.
  • Renaming an Apple silicon installer won’t turn it into an Intel installer.

In short: check the system information, then choose the matching architecture. The two downloads are for different processors, not different feature tiers.

When the download finishes, open the DMG in Finder’s Downloads folder and drag Shadowrocket to Applications. Once copying is complete, eject the disk image and launch the app from Applications. Avoid running it from the mounted DMG; doing so can lead to confusion when you delete the download, eject the disk, or update the app later.

macOS: What to do when you see “Developer cannot be verified”

macOS’s first-launch check and network permission prompts are separate. “Developer cannot be verified” appears when launching the app. After allowing it to open, macOS may separately ask for permission to add a VPN configuration or access network features. Read each prompt carefully, including the app name and permissions requested; don’t click through them automatically.

  1. Check where the file came from

    Confirm the DMG came from this site’s download page and matches your Mac’s architecture. If you’re not sure where it came from, cancel and download it again rather than allowing an old file to open.

  2. Try opening it normally

    Open Shadowrocket from Finder → Applications. Read the full security prompt and check whether it’s about developer verification, file corruption, malware, or a management restriction.

  3. Check Security settings

    For a developer verification warning you can review yourself, open System Settings → Privacy & Security and scroll down to the Security section. Look for the entry related to your recent launch attempt.

  4. Allow this app to open

    Only click Open Anyway if you’ve confirmed the file’s source and macOS offers that option. Authenticate if prompted, then select Open in the confirmation dialog. On older systems, go to System Preferences → Security & Privacy → General.

  5. Review network permissions

    After the app opens, handle network permissions only when you’re ready to use the related connection feature. Confirm the request is from Shadowrocket. If you only want to review your configuration, you can leave the connection off for now.

If you can’t find the option to allow the app, first make sure you tried opening it from Applications, then check Privacy & Security. On a work- or school-managed device, policy may control the option. Ask your administrator to review it rather than trying to bypass the restriction.

Windows: SmartScreen’s More info and Run anyway options

The “Windows protected your PC” SmartScreen prompt is different from a threat detected by Microsoft Defender. SmartScreen may flag an app because it has limited reputation or publisher information. The prompt alone doesn’t prove the file is unsafe—or safe. Before continuing, check the download source, platform, and app and publisher details shown in the prompt.

  1. Check the downloaded file

    Open the Windows section of this site’s download page. Once the download finishes, find the file in File Explorer → Downloads. Make sure it matches the file you just downloaded; don’t run an attachment or a file with the same name from an unknown source.

  2. Expand the warning

    If “Windows protected your PC” appears when you run the file, click More info to see the full app details. The button label varies by system language.

  3. Decide whether to continue

    If you’ve confirmed the source, the details look right, and Run anyway is available, you can select it to continue. If the filename, publisher, or source doesn’t match what you expect, cancel and check again. “Unknown publisher” does not mean the file is trustworthy.

  4. Review the installation prompt

    If User Account Control appears, review the app and publisher information before deciding whether to allow it. After installation, launch Shadowrocket from the Start menu; the installer and the installed app are separate.

If Run anyway isn’t available after you click More info, don’t disable global protection under Windows Security → App & browser control. Smart App Control, S mode, or an organization policy may apply different restrictions. Follow the guidance for your specific system or ask your administrator; standard SmartScreen steps may not apply.

After installation: Import your configuration, then check Global Routing

A successful installation means the app launches; it doesn’t mean you have connection details to use. The steps below assume you already have your own provider and subscription. This site does not provide, sell, or recommend nodes or subscriptions. Subscription links may contain access credentials, so don’t share the full link, QR code, or configuration screenshots publicly while troubleshooting.

First, understand what Home, Config, and Settings are for: Home shows connection entries and status, Config manages rule configurations, and Settings contains app preferences. After importing your existing configuration using the tutorial, make sure its entries appear before choosing a connection target. Updating a subscription and updating a rule configuration are separate actions; updating one doesn’t confirm the other has been refreshed.

Global Routing → Config

Config

Traffic routing depends on the rules in the current configuration. Conditions such as DOMAIN-SUFFIX, IP-CIDR, and GEOIP work alongside the FINAL fallback policy, so don’t assume every configuration routes traffic the same way by default.

Best for: everyday traffic routing after checking the rules and policy names.

Global Routing → Proxy

Routes traffic handled by the app through the proxy policy. This can help you temporarily check whether a problem is caused by rule-based routing. It doesn’t mean every connection from every process on the device is necessarily handled.

Best for: briefly comparing Config’s results using the same destination and request.

Global Routing → Direct

Routes traffic handled by the app directly, so you can compare it with your device’s baseline network connection. Direct doesn’t quit the app or remove existing subscriptions or configurations.

Best for: checking whether the destination is reachable over your baseline network without a proxy.

Change one variable at a time during testing. Note the current Global Routing mode, then revisit the same destination. If Direct works but Proxy fails, first check the address, port, credentials, and protocol settings for the existing connection. If Proxy works but Config fails, check the matching rule and its policy. Reinstalling repeatedly is not a substitute for troubleshooting your configuration.

Common issues: Wrong architecture, permission prompts, and reinstalling

My Apple silicon Mac has the Intel version installed. Should I delete my configuration first?

Quit the app and back up your configuration and any credentials you need, then choose the Apple silicon version on the download page. Don’t delete app data first: replacing the app and clearing user configuration are separate actions. After replacing it, check that your configuration is still there and the connection target is correct.

macOS treats every launch like the first one. What should I do?

Make sure you’re launching from Finder → Applications, not from a DMG that’s still mounted in Downloads. Quit the app, finish copying it, and eject the disk image before launching again. If the prompt keeps appearing, note its exact wording and determine whether it concerns launch verification or network permissions.

There’s no Run anyway option on Windows. Can I still continue?

Don’t force it through the standard SmartScreen steps. Check whether the prompt mentions organization management, Smart App Control, or S mode. Ask an administrator to review a managed computer. If Windows explicitly reports a threat, stop instead of disabling protection to launch the app.

The app opens but can’t connect. Should I reinstall it?

First, check Home to confirm your existing connection is imported. Then check Global Routing, system network permissions, and your baseline network. If the app launches, the installation architecture is usually not the issue. Troubleshoot authentication failures, connection timeouts, and rule-matching problems separately rather than deleting all your data first.

Will my subscription appear automatically if I move to another computer?

Don’t assume installing the app syncs your configuration. Back up the items you need on the original device, then import your own configuration on the new device and check subscription updates separately. Review local file paths, certificates, and device-specific settings individually.

After installation, note your chip type, the exact system warning, where you launched the app from, and the results of your connection tests. These details are more useful for troubleshooting than repeatedly saying it “won’t open.” Launch checks, network permissions, configuration imports, and connection availability are separate steps. Check them in order to avoid mistaking a configuration problem for an installation failure.

Download Shadowrocket for all platforms