Before installing Shadowrocket, check your computer’s architecture, then download the matching installer from our download page. This guide covers choosing a Mac version, opening the app for the first time on macOS, handling Windows SmartScreen, and checking the connection. Only allow an app to open if you’ve confirmed its source and your system offers an option to approve it individually. If you see an alert that the file is damaged, contains malware, or is blocked by an organization policy, stop the installation. Don’t disable system protections.
1. Check your platform and download options
The Apple silicon and Intel versions of Shadowrocket for Mac are built for different processor architectures; they are not different feature tiers. Don’t guess based on the computer’s appearance, purchase year, or the name “MacBook.” Open the Apple menu in the top-left corner and select About This Mac. If it lists “Chip” followed by an Apple chip name, choose the Apple silicon version. If it lists “Processor” followed by an Intel name, choose the Intel version.
On Windows, go to Start → Settings → System → About and check “System type,” then compare it with the requirements listed on the download page. If the installer says it isn’t compatible with your device, check your system and architecture first. Don’t keep trying to run it or rename the file to bypass the restriction.
Start at the download page for all platforms. Shadowrocket for iPhone and iPad is a one-time $2.99 purchase on the App Store; 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. Desktop installers are served from this site’s download directory via the download page. Don’t install files saved from chat attachments or transferred from file-hosting services.
Check in this order: match the architecture, then handle the security alert
“This computer isn’t supported” and “The developer cannot be verified” are different problems. First make sure the installer matches your device, then address any system alert. The steps to allow the app to open only apply if the architecture is correct.
2. Install on Mac: Move the app to Applications before opening it
On the download page, choose the option that matches the information in About This Mac, then wait for the browser to finish downloading. The installer’s format depends on the download provided. Don’t open a temporary file while the browser is still downloading it. Save any work in progress before installing to avoid interrupting other tasks during approval or a restart.
- Find the file: In your browser’s downloads list, choose “Show in Finder.” Make sure you’re opening the file you just downloaded from this site, not an older copy in your Downloads folder.
- Install based on the file format: For a disk image, open it and drag Shadowrocket to Applications. For an archive, extract it first, then move the app. If an installer wizard is provided, read the prompts and follow its steps.
- Open it from its installed location: In Finder, go to Applications, find Shadowrocket, and open it. Don’t keep running it from a mounted disk image or a temporary extraction folder.
- Distinguish a routine confirmation: If macOS only asks whether you want to open an app downloaded from the internet, check the app name and source, then choose “Open.” This confirmation is not the same as a malware detection alert.
If no window appears after copying the app, check the Dock, menu bar, and whether another instance is already running. Launching multiple copies can make troubleshooting confusing. Confirm whether the app is running before checking the system security settings. A successful installation doesn’t mean a connection has been configured; you can’t diagnose a network problem until you’ve imported your existing configuration.
3. If macOS says it can’t verify the developer
Gatekeeper’s first-launch check is separate from checks performed on the app’s configuration. “The developer cannot be verified” is a system launch alert, not an error with a server password, rule, or subscription setting. The steps below apply when your version of macOS offers an option to approve an individual app. Button names and locations may vary slightly by macOS version.
- Try opening the app normally once and read the full alert, then close it. Note the app’s name so you don’t approve a different program you recently downloaded.
- Go to Apple menu → System Settings → Privacy & Security, then scroll down to the Security section. On older systems, go to System Preferences → Security & Privacy → General.
- If the page specifically lists the Shadowrocket app that was blocked and offers “Open Anyway,” choose it only after confirming the file’s source.
- Authenticate as an administrator or with Touch ID if prompted. When the confirmation dialog appears again, choose “Open.” Then return to Applications and check whether the app launches.
If there’s no approval button, don’t force it. Don’t proceed through a routine developer verification prompt if the alert says the app will damage your computer, reports malware, or says the file is damaged—or if the device is managed by an organization. Delete the suspicious file and download it again from the download page. If the same alert appears, save its exact wording and ask your device administrator or support team to investigate. You don’t need to disable Gatekeeper or use Terminal to remove security attributes from downloaded files in bulk.
If there’s no record in Security settings, check that you launched the app from Applications and that the page has refreshed. A managed computer may prevent users from approving apps themselves; having an administrator account doesn’t override every organization policy. Don’t change your computer’s long-term security settings to resolve a one-time launch alert.
4. Windows SmartScreen: Tell a reputation warning from a threat alert
SmartScreen’s “Windows protected your PC” message may relate to file reputation. The message alone doesn’t prove a file is safe or dangerous. Before proceeding, make sure you downloaded it from this site and check the name of the blocked file. If Windows Security explicitly reports malware or you can’t confirm the file’s source, stop. Don’t treat a malware warning like a reputation prompt.
Handle the first-launch alert based on its type
SmartScreen reputation warning
- Confirm the file came from this site’s download page.
- Select “More info” and review the app name and publisher.
- If “Run anyway” appears, select it only if you’ve confirmed the source and decided to proceed.
- Then follow the installer’s instructions. Don’t launch multiple installer instances.
Threat alert or organization policy block
- Note the full alert and the file that was blocked.
- Don’t turn off Microsoft Defender or exclude your entire Downloads folder.
- Check the download source and system requirements again.
- For a managed device, ask the administrator to check the policy. Don’t try to override it.
Approving one app is different from disabling system protection. Only act on the app whose source you’ve confirmed; don’t extend approval to other files.
If “Run anyway” doesn’t appear under “More info,” the device may be managed or subject to system restrictions or other security policies. This button isn’t available in every environment, so following these steps doesn’t guarantee the app can be installed. A User Account Control prompt is a separate type of authorization: it asks whether a program can make changes to your device. Check the program details and grant permission only if needed for the installation. Don’t assume every permission prompt must be accepted.
- After installation, open Shadowrocket from the Start menu. Don’t run the installer again to “launch the app.”
- If the system requests permission, approve only the specific operation shown. Don’t use “Run as administrator” permanently as a general fix for network issues.
- If Windows Firewall asks for access, decide based on the app’s actual function and your network environment. Don’t allow unnecessary inbound access on all networks just to connect for the first time.
5. After the first launch: Verify the connection before changing rules
Seeing the main window only confirms that the app has launched. Next, use your existing provider configuration to import or add a connection in Home, then check the server address, port, authentication details, and transport parameters. In Shadowrocket, Home, Config, and Settings are used for connection management, rule configuration, and app settings. Desktop layouts may differ; follow the item names shown in your app rather than relying on screenshots of the mobile interface.
The configured port must match the server. For example, if your provider specifies 443, enter that value as given; it isn’t a fixed port for every protocol. A successful launch, a latency test result, and a working webpage are separate checks. Passing one doesn’t replace the others. Note where the failure occurs, change one setting, then test again.
Global Routing → Config
RecommendedWith a valid configuration, requests are handled according to the rules. Check the rule order and target policy in Config. Don’t assume Config means “connect directly if no rule matches”; the fallback behavior depends on the actual configuration, including FINAL.
Best for: Everyday routing with an established rule configuration
Global Routing → Proxy
Handle requests intercepted by the app as proxied, to compare whether different results are caused by rule selection. This won’t fix an incorrect server address, port, or authentication details, and doesn’t mean all system traffic will necessarily be intercepted.
Best for: Briefly comparing proxy connectivity and rule outcomes
Global Routing → Direct
Handle requests intercepted by the app as direct connections. If webpages load after switching, that only shows the current direct path is available; it doesn’t mean the proxy connection is working again.
Best for: Comparing against the proxy route while changing one variable
After testing, restore the Global Routing setting you plan to use long term. If the interface shows Scene, it’s a separate routing mode for handling traffic by scenario; don’t use it as a default troubleshooting setting unless you understand its conditions. There’s no need to enable Settings → On Demand right after installation. Connect and test manually first, then configure conditional connections once you’ve confirmed the results, so automatic triggers don’t interfere with troubleshooting.
- App won’t open: Recheck the architecture, installation location, and system security alert.
- App opens but can’t connect: Check the address, port, protocol, and system time in your existing configuration. Don’t repeat system approval steps.
- Only some destinations fail after connecting: Check which rules match in Global Routing and Config, then investigate DNS and whether the destination is reachable.
6. Common first-install questions
I downloaded the Intel version on an Apple silicon Mac. Should I continue?
Exit the current installation and return to the download page to choose the Apple silicon version. Don’t ignore the native version just because the Intel version might run through a compatibility feature. Keep one clearly identifiable copy of the app to avoid opening different files from different locations later.
What if the same alert appears every time I open the app on Mac?
First, make sure the app is in Applications and that you’re opening the same copy each time—not another copy in a fresh download or disk image. Then check the record under System Settings → Privacy & Security. If the alert keeps appearing after approval, save its full text and don’t repeatedly approve an unknown file.
On Windows, where can I find “Run anyway” if it doesn’t appear?
First, check whether the alert mentions an administrator policy or system restriction. This option isn’t always available. For a managed device, contact your administrator. On a personal device, check system requirements and the file’s source; don’t disable security features to force the button to appear.
Why isn’t there a working connection after the desktop app installs?
Installing the app doesn’t include a connection configuration. Import an existing configuration from your service provider and check its settings. This site doesn’t provide, sell, or recommend nodes or subscriptions. Buying the app is not the same as buying a service plan.