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.
- “The application is not supported on this Mac”: check the architecture first, then review the system requirements on the download page.
- “The application is in use” while copying: quit Shadowrocket before replacing it. Don’t keep multiple copies running.
- The download was interrupted or the disk image won’t open: delete the incomplete file and download it again from this site. Don’t use a partial download.
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.
-
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.
-
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.
-
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.
-
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.
-
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.
-
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.
-
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.
-
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.
-
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.
- Microsoft Defender shows a threat name or quarantine record: stop, keep the warning details, and check the file’s source. Don’t force it to run by adding an exclusion.
- “This app can’t run on your PC”: check System type and the system requirements. This isn’t a SmartScreen bypass issue.
- Your browser blocked the file during download: read its explanation and check the download page on this site. Don’t keep dismissing multiple security warnings.
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
ConfigTraffic 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.
- A website works in the browser but an app can’t connect: check whether the app follows the system proxy and which traffic the current connection method handles.
- A domain won’t load, but the baseline network works: check DNS and rules before changing system security settings.
- A connection starts automatically after reboot: check the app’s startup settings. If On Demand is enabled in your configuration, review its conditions under Settings → On Demand.
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.