From 2ec11cfc3aab0f8382d90c79516881c9bfcd41c0 Mon Sep 17 00:00:00 2001 From: Homero Thompson Date: Mon, 26 Oct 2026 10:41:32 +0000 Subject: [PATCH] Docs: how to open the macOS build when the Gatekeeper blocks it (#5393) (#6566) * claim: #5393 * docs: how to open the macOS build when the Gatekeeper blocks it (#5393) --- docs/book/src/guide/getting-started.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/book/src/guide/getting-started.md b/docs/book/src/guide/getting-started.md index 4481e9b44..e0e923a97 100644 --- a/docs/book/src/guide/getting-started.md +++ b/docs/book/src/guide/getting-started.md @@ -24,6 +24,16 @@ cargo run --release -p solidcraft -- --sample # opens with a sample part Open the release `.dmg` and drag `SolidCraft.app` onto Applications. +The macOS build is signed ad-hoc and not notarized, so macOS blocks the first launch with +"SolidCraft can't be opened, because Apple can't verify if the app is vulnerable". Open +**System Settings › Privacy & Security**, scroll down to the message about SolidCraft, click +**Open Anyway** and confirm: the app opens normally from then on. From a terminal, remove the +quarantine flag instead: + +```sh +xattr -dr com.apple.quarantine /Applications/SolidCraft.app +``` + When updating from a build released under the previous product name, follow the [macOS upgrade notes](https://github.com/bherbruck/solidcraft/blob/main/docs/compatibility.md#macos) so you replace it rather than install a second copy.