Skip to content

docs: add install section with macOS Gatekeeper first-open guide - #331

Merged
ajianaz merged 1 commit into
developfrom
docs/macos-install-gatekeeper
Sep 9, 2026
Merged

ajianaz merged 1 commit into
developfrom
docs/macos-install-gatekeeper

Conversation

@ajianaz

@ajianaz ajianaz commented Sep 9, 2026

Copy link
Copy Markdown
Collaborator

What

Docs-only: add an Install section to the README.

  • Platform → release-file table (macOS aarch64/x64 DMGs, Windows setup, deb/rpm) linking to the latest release
  • macOS Gatekeeper first-open guide: xattr -rd com.apple.quarantine /Applications/CorIn.app as the fast path after install, plus the no-Terminal alternatives (control-click → Open; Privacy & Security → Open Anyway for newer macOS)
  • Explains why the block happens: builds are ad-hoc signed (signingIdentity: "-"), Apple notarization not yet in place

Why

macOS builds are signed ad-hoc and not notarized, so Gatekeeper blocks the first launch with "unidentified developer". Users had no documented way past it, and support burden lands in DMs/issues. This makes the workaround official and discoverable right where users look first (README).

Testing

  • Docs-only, single file (README.md), no code touched
  • File names in the table verified against actual v0.4.0 release assets (gh release view)
  • Gatekeeper behavior verified against Tauri signing config in this repo

- Platform file table for macOS (aarch64/x64), Windows, Linux (deb/rpm)
- Gatekeeper: xattr -rd com.apple.quarantine /Applications/CorIn.app as the
  fast path; control-click Open and Privacy & Security Open Anyway as the
  no-Terminal alternatives (Sequoia behavior included)
- Explains why: ad-hoc signature, notarization not yet in place
@github-actions

github-actions Bot commented Sep 9, 2026

Copy link
Copy Markdown

🔍 Cora AI Code Review

✅ No issues found. Code looks good!


Review powered by cora-code · BYOK · MIT

@ajianaz
ajianaz merged commit f60aefb into develop Sep 9, 2026
17 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant