STACIO WIKI · INSTALLATION TROUBLESHOOTING
Fix “Stacio is damaged” or cannot be opened on macOS
1. Confirm that this guide applies first
Use this guide only for Stacio installers downloaded from the official Stacio website, an official GitHub Release, or an official Gitee Release. The current installer distribution is not Apple-notarized, so macOS source and quarantine protections can show a warning on first launch.
Do not use the command in this guide to remove quarantine attributes from unknown software, email attachments, or apps downloaded from file-sharing sites. The command does not repair a damaged file and should not be used to bypass a warning for software you do not trust.
Check the source first. If the file did not come from an official release, or its download was interrupted, forwarded, or rewritten by an archive tool, delete that copy and download it again from an official source.
2. Install Stacio correctly first
- Confirm the installer matches your Mac: Apple Silicon Macs need
arm64; Intel Macs needx86_64. - Open the DMG, then drag
Stacio.appto the Finder Applications folder. - Wait for the copy to finish, then quit the DMG and eject the installation volume. Do not run Stacio directly from the DMG window or Downloads folder.
- Find
Stacio.appin Finder's Applications folder before trying to launch it again.
When the app is located at /Applications/Stacio.app, the command below can be used as written. If you installed it elsewhere, substitute the real path.
3. Prefer Finder's first-launch approval
3.1 Open from the context menu
- Open the Applications folder in Finder.
- Control-click or right-click
Stacio.app. - Choose Open, then choose Open again in the confirmation window.
3.2 Allow it in Privacy & Security
If macOS only says it cannot verify the developer or blocks the launch, open System Settings > Privacy & Security. In the Security area, verify that the notice is for Stacio, then choose Open Anyway. You normally need to do this only once.
4. If macOS still says the app is damaged
After confirming the source, completing the installation, and trying Finder's normal approval flow, you can remove the macOS download quarantine attribute from Stacio. Quit Stacio completely, open Terminal, and run:
sudo xattr -rd com.apple.quarantine /Applications/Stacio.app
- Paste the command and press Return.
- When macOS asks for an administrator password, typed characters do not appear on screen. This is normal. Enter the password and press Return.
- If the command prints nothing and returns to the prompt, it normally completed. Return to Finder and open Stacio again.
This command removes only the com.apple.quarantine attribute from Stacio.app. It does not give the app a new signature, replace macOS malware checks, or repair an incomplete installer.
4.1 If Stacio is not in Applications
When you keep Stacio elsewhere, replace the path with the real application path and quote it. For example:
sudo xattr -rd com.apple.quarantine "/Users/your-name/Applications/Stacio.app"Do not run this command on the DMG file. First move Stacio.app to a stable local folder, then target that app.
5. If the command errors or Stacio still does not open
| What you see | Check and next step |
|---|---|
No such file or directory | Stacio is not at /Applications/Stacio.app. Confirm its location in Finder, or run ls /Applications/Stacio.app, then use the correct path. |
| The damaged-app warning remains | Delete the current DMG and app copy, download from the official page again, and compare the published file size and SHA-256. |
| The app quits immediately or cannot run | Confirm the package architecture matches the Mac and that macOS is version 14 or later. A quarantine attribute is not the cause of every launch problem. |
| A managed work Mac cannot allow the app | MDM, endpoint protection, or an organization security policy can prevent a launch. Contact the device administrator instead of attempting to bypass the policy. |
6. What to include when contacting support
If a clean download and these steps still do not work, contact support@stacio.cn with the Stacio version, macOS version, Apple Silicon or Intel, a screenshot of the full message, the installer source, and any command error text. Do not send passwords, private keys, License Keys, or other sensitive credentials.
