This guide is for anyone installing Shadowrocket on a computer for the first time. Check your Mac chip or Windows system type, then choose the right installer from our download page. If the system blocks the app, follow the steps for that specific warning instead of disabling security protections across the board. Once installed, check your existing subscription, Config, and Global Routing to distinguish an app that won’t open from a connection that won’t work.
Before you install: Check the download source and device type
Mac and Windows users can download the desktop installers from our download page; you don’t need to follow the iPhone download process. On the download page, Mac users should choose the .dmg for Apple silicon or Intel. Windows users should check the Windows section for the .exe and its compatibility notes. Don’t determine compatibility by a computer’s appearance, purchase year, or file icon alone.
On the App Store listing for iPhone / iPad, the developer is Shadow Launch Technology Limited and the app ID is 932747118. Check the App Store page for system requirements. For computer installs, refer to the platform requirements on our download page; mobile system requirements do not apply to desktop versions.
Choosing a Mac version: Check About This Mac
If the Chip field lists an Apple chip, choose the Apple silicon version. If the Processor field lists Intel, choose the Intel version. Open the Apple menu in the top-left corner of the screen and select About This Mac, then check Chip or Processor. The label may vary with your system language, but the hardware information is what matters.
Choose the Mac installer based on your chip
Apple silicon
- About This Mac shows an Apple chip under Chip.
- Go to the Mac section of the download page and choose “Mac Apple Silicon.”
- The arm64 or ARM architecture label corresponds to this chip type.
Intel
- About This Mac shows an Intel processor under Processor.
- Go to the Mac section of the download page and choose “Mac Intel.”
- The x64 or x86_64 architecture label corresponds to this processor type.
Don’t use a model category such as “MacBook” or “desktop Mac” to identify the chip. The same selection rule applies to both installers, and both are free.
If you see “This application cannot be opened on this Mac,” first check your chip and the system requirements on the download page. An incompatible architecture is not the same as a security block. Clicking Open Anyway won’t make an incompatible app compatible, and repeatedly changing system security settings isn’t a solution.
Install on Mac: Copy the app, then open it from Applications
A .dmg is a disk image. Opening it does not install the app in its usual location. Wait for the download to finish, mount the image, then copy the app to Applications. If the image includes installation instructions, follow them. Don’t treat the temporary location inside the mounted image as the permanent install location.
-
Check your chip
Open the Apple menu → About This Mac. Note the Chip or Processor information, then choose the matching Mac version from our download page.
-
Open the disk image
In Finder → Downloads, find the completed .dmg and double-click it. If the download is still in progress, wait until it finishes.
-
Copy the app
Drag Shadowrocket from the mounted image to Applications. If an older app with the same name is already there, quit it first and make sure you’ve saved any configuration you need before replacing it.
-
Open it for the first time
Open Shadowrocket from Finder → Applications. If the system asks whether to open an app downloaded from the internet, check the app name and source before confirming.
-
Eject the disk image
Once you’ve confirmed the app in Applications opens, eject the disk image from the Finder sidebar. Keeping or deleting the downloaded file won’t affect the app copied to Applications.
Replacing the app and restoring configuration are separate tasks. Don’t assume reinstalling will always clear settings or preserve every configuration. Before changing computers or uninstalling, note which Config you use and export any configuration you want to keep using the app’s export feature.
macOS blocks: Tell verification prompts, compatibility issues, and security warnings apart
If you see “Cannot verify developer,” check the download source, then use the system’s option for that specific app rather than disabling security protections entirely. Try opening the app once and dismiss the alert. Then go to Apple menu → System Settings → Privacy & Security and scroll to Security. If Open Anyway is available for that blocked app, confirm the app name matches before proceeding.
Installation prompts and what to do
| Prompt or symptom | Where to check | What to do |
|---|---|---|
| The developer cannot be verified, or macOS cannot check the app for malicious software | System Settings → Privacy & Security → Security | After checking the source, use Open Anyway for this app only if the system offers it, then complete any authentication prompt. |
| The app will damage your computer, or malware was detected | The exact system warning and any security software detection records | Stop. Don’t treat this as a routine verification prompt. Keep the warning text, check the download source, and investigate further. |
| The disk image won’t open, or the file is damaged | The browser’s download history and the file in Finder | Delete incomplete or abnormal files and download the installer again from our download page. If the error persists, note the exact message; don’t use Terminal commands to force past the protection. |
| The app cannot run on this Mac | About This Mac and the platform requirements on the download page | Check whether your Mac has Apple silicon or Intel and review the system requirements. Security overrides won’t fix an architecture mismatch. |
Open Anyway won’t appear in every case. Whether it’s available depends on the warning, your recent attempt to open the app, and device management policies. On older systems, the option may be under System Preferences → Security & Privacy → General. If your Mac is managed by your employer or school, ask the administrator to handle policy restrictions; don’t bypass them.
- Make sure the app you just tried to open is Shadowrocket in Applications, not another file with the same name.
- If the system asks for your password or Touch ID, read the authorization prompt and confirm it applies to this app launch.
- If the app later requests network-related permissions, review each request separately. Allowing the app to open does not grant every network permission.
Install on Windows: Respond to each SmartScreen prompt
The SmartScreen “Windows protected your PC” warning doesn’t necessarily mean the installation failed. It may be related to the downloaded file’s reputation. The warning alone doesn’t prove the file is unsafe, and the option to continue doesn’t prove it’s safe. First confirm that the file came from our download page, then decide whether to proceed.
-
Check your system
Go to Settings → System → About and check System type against the Windows installation notes on our download page. If you have an ARM device, don’t assume it’s compatible just because the .exe downloads.
-
Get the installer
Download the .exe from the Windows section of our download page and wait for the browser to finish. Before double-clicking, you can right-click the file → Properties to check its type and source information.
-
Read the warning
If SmartScreen appears, select More info to check the app and publisher details. Stop if the information looks unusual or the source is unclear.
-
Confirm before running
Proceed only after checking the source, understanding the risk, and confirming that the system offers Run anyway. If that option isn’t available, don’t force the app to run by disabling SmartScreen or other protections.
-
Finish installation
Follow the installer’s on-screen steps. If User Account Control appears, check the program name, publisher, and requested changes before deciding whether to allow them.
SmartScreen and User Account Control appear at different stages. SmartScreen may show when you run a downloaded file; User Account Control asks you to confirm the permissions the app requests. If you see “Unknown publisher,” check the file source and prompt details—it doesn’t mean the software’s identity has been verified.
After installation: Confirm the app opens, then check your connection settings
Seeing the Shadowrocket window means the app has started; it doesn’t mean you have a working connection. First check your own subscription and configuration, then review the routing mode. The desktop layout may differ, so use feature names such as Home, Config, and Global Routing rather than assuming the mobile button locations apply.
- Existing service: Import your own subscription or node details, then check that entries appear. If an update fails, note the error instead of repeatedly posting the full subscription URL.
- Config: Make sure the intended configuration is selected. Updating a subscription entry and switching the Config file are different operations; don’t blame the installer for rules that aren’t enabled.
- Global Routing: Proxy, Direct, Config, and Scene control proxying, direct connections, configuration rules, and scene selection. Check the current selection first. A direct connection under Direct can’t tell you whether a proxy node works.
- Connection test: Run Connectivity Test wherever it’s available in the app and note exactly which check failed. A single timed-out entry and a complete loss of web access need to be investigated separately.
- Automatic behavior: If you’ve configured On Demand, check whether an automatic connection condition is active. While troubleshooting, distinguish manual connection results from condition-triggered results, and change one setting at a time.
Change one setting at a time while troubleshooting so you can tell what made a difference. For example, if the app opens and entries import correctly but only certain domains fail, check Config matching rules and DNS instead of reinstalling right away. If the app quits before showing its main window, first note the system error, device architecture, and launch location.
Common issues: App won’t open, repeated warnings, and old configuration
I dragged the Mac app to Applications. Why is it still running from the disk image?
Quit Shadowrocket completely, eject the disk image in Finder, then reopen the app from Applications. If an old Dock shortcut no longer works, remove it and add the open app from Applications to the Dock so the shortcut doesn’t point to the temporary mounted location.
What if Open Anyway isn’t in Privacy & Security?
First check that the warning is a standard developer verification prompt, then try opening the app again from Applications. If the option still doesn’t appear, note the system version and exact warning, and check whether the device is managed. Don’t use the standard override for malware or damaged-app warnings.
What if Run anyway doesn’t appear after I click More info in Windows?
This may be due to a system policy or a stricter security block. Check Windows Security → Protection history to distinguish a reputation warning from a confirmed threat detection. On a managed device, contact the administrator; don’t change policies or disable protections just to make the continue button appear.
The app opens, but it won’t connect. Should I reinstall it?
First check that your existing service is active, the subscription updated successfully, the right Config is selected, and Global Routing is set to the intended mode. Review these results before deciding what to do next. Reinstalling won’t fix an expired service, incorrect rule selection, or an unreachable remote service.
What should I save before replacing the installer?
Use the app’s existing features to export any Config you need, save essential subscription details, and note the active configuration and routing mode. Exported files may contain credentials, so store them securely. Don’t rely on leftover files after uninstalling as your only backup.
Get the right version for your device, then continue with setup
Get Shadowrocket for iPhone / iPad on the App Store for a one-time $2.99 purchase. The Mac (Apple silicon / Intel), Windows, Android, and Linux versions are free. Choose your device version on the download page, then follow the guide to import your existing service and configuration.