Skip to content

SolidCraft: an open-source parametric 3D CAD application built in pure Rust. Desktop, web, and automation through MCP.

Docs: how to open the macOS build when the Gatekeeper blocks it (#5393) (#6566)

Homero Thompson2ec11cfc3aab
diff --git a/docs/book/src/guide/getting-started.md b/docs/book/src/guide/getting-started.md
index 4481e9b44f..e0e923a97f 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.