# Install on macOS Source: https://docs.ideharmony.com/getting-started/macos **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 1. Open [ideharmony.com/download](/download). If **macOS** is not listed as published, stop. There is nothing honest to install yet. 2. 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) ```bash curl -fsSL https://ideharmony.com/install.sh | sh ``` The generated script: 1. Detects Darwin + architecture. 2. Selects the matching published artifact (or fails if none). 3. Downloads via a short-lived URL. 4. Verifies **exact byte size** and **SHA-256**. 5. Mounts the DMG and installs to `/Applications` (or `~/Applications` if needed). 6. Creates the `nala` CLI shim under `~/.local/bin`. Inspect first: ```bash 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 1. Download the DMG for your architecture. 2. Compare SHA-256 to the value shown on the page (copy button). 3. 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:** 1. Double-click **Harmony** and dismiss the damaged dialog with **Cancel**, not Move to Trash. 2. 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**. 3. 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:** 1. Control-click (right-click) **Harmony** in Applications → **Open**. 2. Click **Open** again in the dialog. macOS remembers the exception. **Terminal fallback, any version:** ```bash xattr -d com.apple.quarantine /Applications/NALA.app ``` Do **not** disable Gatekeeper system-wide. Full guide: [download page → Getting past the OS warning](/download#first-open). ## Verify ```bash harmony version harmony doctor harmony desktop ``` Open a new terminal if `nala` is not on PATH (`~/.local/bin`). ## Next - [Your first workspace](/docs/getting-started/first-workspace) - [Connect a provider](/docs/getting-started/connect-a-provider) - [Uninstall](/docs/getting-started/uninstall)