# Install on Linux Source: https://docs.ideharmony.com/getting-started/linux **Outcome:** Harmony installed on Linux when a Linux artifact is published on the current channel, with digest verification before any package or AppImage runs. ## Before you start 1. Open [ideharmony.com/download](/download). If no Linux artifact is listed, stop. 2. Prefer DEB on Debian/Ubuntu, or AppImage anywhere else, including Fedora/RHEL, until an RPM build exists. ## Option 1 — install.sh (recommended) ```bash curl -fsSL https://ideharmony.com/install.sh | sh ``` On Linux x64 the script prefers DEB if `dpkg` exists, else AppImage. **RPM is not a v1 published format** — Fedora/RHEL users should use AppImage until an RPM is built, channel-listed, and downloadable. It always: - Downloads via a short-lived private URL - Checks **byte size** and **SHA-256** before installing - Stops on mismatch (does not run a bad file) Inspect first: ```bash curl -fsSLo install-nala.sh https://ideharmony.com/install.sh less install-nala.sh sh install-nala.sh ``` ## Option 2 — package from the download page 1. Download DEB or AppImage. 2. Copy the SHA-256 from the download page and verify: ```bash sha256sum ./nala_*.deb sha256sum ./Harmony-*.AppImage ``` 3. Install: ```bash # DEB sudo dpkg -i ./nala_*.deb || sudo apt-get install -f -y # AppImage chmod +x ./Harmony-*.AppImage ./Harmony-*.AppImage ``` The two Linux downloads are named differently on purpose. The AppImage is `Harmony--x64.AppImage`, because there the filename is just a label. The Debian package is `nala__amd64.deb`, because there the name is the package identity that `dpkg` matches upgrades on: renaming it would make the next release a different package rather than a newer one. AppImage may need `libfuse2` (`sudo apt install libfuse2` or distro equivalent). ## Unsigned packages Linux packages here are not code-signed the way Windows Authenticode or Apple notarization works. **Trust the published SHA-256** on /download. Full interim notes: [unsigned install guide](/download#first-open). ## Verify ```bash harmony version harmony doctor harmony desktop ``` CLI shims typically land in `~/.local/bin`. Open a new shell if needed. ## Next - [Your first workspace](/docs/getting-started/first-workspace) - [Connect a provider](/docs/getting-started/connect-a-provider) - [CLI reference](/docs/cli) - [Uninstall](/docs/getting-started/uninstall)