Install on macOS
Install Harmony on macOS with install.sh, verify SHA-256, and get past Gatekeeper on an unsigned preview.
Outcome: Harmony installed on macOS when a macOS artifact is published on the current channel, verified by size and SHA-256, with Gatekeeper handled without disabling system security.
Before you start
- Open ideharmony.com/download. If macOS is not listed as published, stop. There is nothing honest to install yet.
- Prefer Apple Silicon (
mac-arm64) or Intel (mac-x64) matching your machine.
NOTE
The site never offers a download for a platform missing from the release manifest. install.sh fails closed the same way.
Option 1 — install.sh (recommended)
curl -fsSL https://ideharmony.com/install.sh | sh
The generated script:
- Detects Darwin + architecture.
- Selects the matching published artifact (or fails if none).
- Downloads via a short-lived URL.
- Verifies exact byte size and SHA-256.
- Mounts the DMG and installs to
/Applications(or~/Applicationsif needed). - Creates the
nalaCLI shim under~/.local/bin.
Inspect first:
curl -fsSLo install-nala.sh https://ideharmony.com/install.sh
less install-nala.sh
sh install-nala.sh
Option 2 — DMG from the download page
- Download the DMG for your architecture.
- Compare SHA-256 to the value shown on the page (copy button).
- Open the DMG and drag Harmony to Applications.
Gatekeeper on unsigned preview
Unsigned preview builds are expected. Gatekeeper may say “Harmony is damaged and can’t be opened.” That wording means unsigned, not corrupt, when the SHA-256 matches.
macOS 15 Sequoia:
- Double-click Harmony and dismiss the damaged dialog with Cancel, not Move to Trash.
- Open System Settings → Privacy & Security, scroll to Security, and click Open Anyway next to the Harmony notice (it stays for about an hour after the blocked attempt). Authenticate, then click Open.
- Control-click → Open no longer overrides Gatekeeper for unnotarized apps on Sequoia; the System Settings route is the only GUI one.
macOS 13 Ventura / 14 Sonoma and earlier:
- Control-click (right-click) Harmony in Applications → Open.
- Click Open again in the dialog. macOS remembers the exception.
Terminal fallback, any version:
xattr -d com.apple.quarantine /Applications/NALA.app
Do not disable Gatekeeper system-wide. Full guide: download page → Getting past the OS warning.
Verify
nala version
nala doctor
nala desktop
Open a new terminal if nala is not on PATH (~/.local/bin).