Skip to main content
Harmony
Download

Install on Linux

PreviewAvailable on: LinuxShips in the preview channel only. Not a stable release.

Install Harmony on Linux via DEB or AppImage, verify SHA-256, and first-run checks.

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. 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)

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:

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:
sha256sum ./nala_*.deb
sha256sum ./Harmony-*.AppImage
  1. Install:
# 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-<version>-x64.AppImage, because there the filename is just a label. The Debian package is nala_<version>_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.

Verify

nala version
nala doctor
nala desktop

CLI shims typically land in ~/.local/bin. Open a new shell if needed.

Next