Installing Shadowrocket on a Mac or Windows PC for the first time? Check your system details, then choose the matching installer on the download page. If your system blocks it, read the exact warning and verify the file’s source and signature. Only consider allowing that specific app if you’ve confirmed it’s trustworthy and your device policy permits it. The wrong architecture, a detected threat, or an organization’s security policy can’t be fixed by bypassing a warning.
Choose Apple Silicon or Intel for Mac
Open Apple menu → About This Mac in the top-left corner of your screen. Check whether the window shows Chip or Processor, then note the value. Don’t choose a package based on the Mac’s appearance, screen size, or macOS version: models in the same product line can use different architectures, and two Macs running the same macOS version may need different installers.
Apple Silicon Mac
- Field to check
Chip- What to look for
Apple M1、Apple M2、Apple M3- Architecture
arm64- Download
- Mac · Apple Silicon
If a native package is available for your Mac, you don’t need to install Rosetta just for this setup.
Intel Mac
- Field to check
Processor- What to look for
Intel Core i5、Intel Core i7- Architecture
x86_64- Download
- Mac · Intel
An Intel Mac needs the Intel package; it can’t run an app containing only Apple Silicon code.
Go to the client download page and choose the matching Mac download. If you download the file on a different computer, choose based on the Mac where you’ll install it—not the device used to download it. Wait for the browser to finish, then locate the file in its download history to avoid opening an older copy from the same folder.
First launch on macOS: When to use Open Anyway
Read the exact Gatekeeper warning before deciding what to do. “Apple cannot verify the developer” or “Apple cannot check it for malicious software” means the system couldn’t complete its trust checks; it doesn’t mean the app has been determined to be safe. If macOS says the app will damage your computer, its signature has been revoked, or it remains damaged after downloading it again, stop. These aren’t routine first-launch confirmations.
Open the correct file
In Finder, go to Downloads and locate the file you just downloaded. Follow the installer’s instructions. If a disk image asks you to drag the app to Applications, finish copying it first, then open the copy from Finder → Applications.
Note the exact warning
If the first launch is blocked, note the warning text and app name, then close the dialog. If it says the app isn’t compatible with your current system, check the chip and system details in About This Mac instead of trying to allow it.
Verify the source
Make sure you downloaded the file from the matching platform link on the download page, and check any available signature information. Stop if the file was forwarded to you, the publisher can’t be verified, or the signature check fails. A filename and icon don’t prove where a file came from.
Check for the approval option
Once you’ve verified the file is trustworthy, open Apple menu → System Settings → Privacy & Security on recent macOS versions and look in the
Securitysection. IfOpen Anywayappears next to the blocked app, confirm the app name, authenticate when prompted, and approve opening it. This option is usually available for about an hour after the blocked launch attempt.Confirm the app launches
Make sure you’re opening the copy in Applications and check that the main window appears normally. Seeing only an installer or disk image window doesn’t mean the client has launched. If your device policy doesn’t allow you to proceed, contact your administrator.
First run on Windows: SmartScreen, signatures, and permissions
Go to Settings → System → About and find System type under Device specifications. Compare it with the system and architecture requirements listed for the Windows download. An x64-based processor and an ARM-based processor are different; seeing 64-bit operating system alone doesn’t tell you which package to choose. If the download page doesn’t list your setup, don’t mistake a launch error for a SmartScreen warning.
- In File Explorer, find the installer you just downloaded, right-click it, and open
Properties. If there’s aDigital Signaturestab, select the signature and clickDetailsto check that it’s valid and the signer matches the publisher information. If the tab is missing, the signature is invalid, or you can’t verify the signer, don’t proceed by bypassing the warning. - After opening the installer, if the window is titled
Windows protected your PCand says SmartScreen blocked an unrecognized app, don’t choose to run it yet. If you’ve verified the file is trustworthy and your device allows it, clickMore infoto check the app name and publisher. Continue for this file only if both match andRun anywayis available. If the button isn’t there, don’t change system protection settings to make it appear. - If you see
User Account Control, it’s asking whether to allow the program to make changes to your device—not showing a SmartScreen warning. Check the program name and publisher. On a personal PC, approve only if the details match what you expect; on a managed device, ask your administrator. IfWindows Securityreports a threat or says the file was quarantined, keep it blocked and don’t restore it from quarantine.
Personal PCs and managed devices
The same warning doesn’t always offer the same options. A button available on a personal PC may be hidden by company or school policies. Having a local administrator password also doesn’t mean your organization has approved the software.
Choose the next step based on device management
Personal PC
- Check your download history to confirm the file came from the matching platform link, and rule out an older package or the wrong architecture.
- Identify the type of warning and verify the file. Consider allowing this specific file only if your system permits it and the warning is solely about first-run trust.
Company or school device
- Give your administrator the operating system, processor architecture, installer filename, and exact warning text. Say whether the block occurs during installation or on first launch.
- Ask your administrator to confirm whether installation is allowed and whether there’s an approved deployment method. Before sharing a screenshot, hide unrelated details such as account names and device IDs.
Allowing one file is not the same as disabling system protection. These steps don’t require turning off Gatekeeper or SmartScreen.
Can’t open it after installation? Troubleshoot the specific issue
Mac says “app is damaged.” Will downloading it again help?
First make sure the browser finished the download, then download the file again from the link for your Mac’s chip. Find the new file in your download history; don’t reopen an older file with the same name. If the warning persists after downloading from the correct source, or the signature check fails, stop and keep the exact warning text.
Why is my Apple Silicon Mac suddenly asking to install Rosetta?
Go back to About This Mac and check Chip, then see whether you selected the Intel download in your download history. If you installed the wrong package, quit the app, get the Apple Silicon version, and replace it as instructed. Open the new copy from Applications to avoid launching the old package from a disk image or shortcut.
Windows says “This app can’t run on your PC.” Is that SmartScreen?
Don’t use the SmartScreen steps for this message. Check System type and the installer’s supported systems first, then confirm the download completed and that you opened the Windows installer. If everything matches but the error persists, record the full message. Don’t try compatibility mode or repeatedly run it with elevated permissions.
The main window opens, but it won’t connect. Should I reinstall?
If the main window appears normally, the issue has moved from “app won’t launch” to troubleshooting a connection that hasn’t been established. First check whether you’ve added the configuration needed to connect; obtain nodes or subscriptions from your service provider. If a configuration is already added, follow the guide to check the connection status. A connection failure doesn’t mean the installer is incompatible.