Install troubleshooting
Everything Gatekeeper might throw at you on the first launch, and the shortest way past each one.
- System
- Detecting…
- Chip
- Detecting…
- Recommended build
- Detecting…
Chip detection is a best guess from your browser. If you are unsure, open → About This Mac and read the Chip line.
This build is signed with a Developer ID and notarized by Apple, so Gatekeeper lets it through on the first launch. If you still see a warning, you are running an older download — delete it and grab the current build from the home page.
Clean install, step by step
- 1Download the build listed for your chip above.
- 2Unzip it — double-click the .zip if macOS has not already done it for you.
- 3Drag Casement.app into your Applications folder, then open it from there.
- 4It opens straight away — nothing else to do.
Remove the quarantine flag
xattr -dr com.apple.quarantine /Applications/Casement.app
Check whether the flag is still there
xattr -l /Applications/Casement.app
Confirm the architecture of the build
file /Applications/Casement.app/Contents/MacOS/Casement
Common errors
"Casement is damaged and can't be opened"
That message is Gatekeeper reacting to the quarantine flag on an unsigned download — the app is not corrupt. Drag Casement into Applications, then use the one-click helper above, or run xattr -dr com.apple.quarantine /Applications/Casement.app in Terminal. If the app is still in your Downloads folder, point the same command at ~/Downloads/Casement.app instead. Then open it again.
"Apple could not verify Casement is free of malware"
Open System Settings → Privacy & Security, scroll to the Security section, and press "Open Anyway" next to the Casement entry. It appears for about an hour after the blocked launch.
The app bounces once in the Dock and quits
Casement ships for Apple Silicon only, and that build will not launch on an Intel Mac. Check Apple menu → About This Mac: if it lists an Intel chip, Casement cannot run on it yet.
The download unpacks into a folder, not an app
Safari unzips downloads automatically, so you may see Casement.app already sitting in Downloads. Drag that straight into /Applications — there is nothing else to open.
Casement disappeared after an update
The updater swaps the bundle atomically; if a swap is interrupted, a Casement.app.old folder is left beside it. Rename that back to Casement.app, or simply download and unzip the build again — your vault, favorites and history live outside the app bundle.