Skip to main content
The documented public install path is GitHub Releases. Download the asset for your operating system from the latest finalized release. Release assets also include updater manifests such as latest-macos.json, latest-linux.json, and latest-windows.json, plus checksums and signatures where available. The download links use stable latest-release aliases and open the GitHub Release asset in a new tab. For a specific version, use the full GitHub Releases page. The DEB and RPM assets enroll Locality’s signed package repository during installation. Later system-wide package-manager upgrades include Locality.

​
macOS

  1. Open the GitHub Releases page.
  2. Download the latest finalized Apple Silicon DMG: Locality_Mac_v<version>.dmg.
  3. Move Locality.app to Applications.
  4. Open Locality and complete onboarding.
The public macOS build is currently Apple Silicon focused.

​
Linux

Locality for Linux is supported only on these distributions:
  • Ubuntu 24.04 or newer;
  • Debian 13 or newer;
  • Fedora 40 or newer;
  • openSUSE Tumbleweed;
  • Linux Mint 22 or newer.
Other Linux distributions and older versions are unsupported, even if a package can be installed there. On Ubuntu 24.04+, Debian 13+, or Linux Mint 22+, download the .deb release asset and install it locally. The package installs the Locality APT source and its dedicated keyring:
Future releases are then included in the normal system upgrade:
On Fedora 40+, download the .rpm release asset and install it locally:
Future releases are included in the normal system upgrade:
The same repository works with yum update on supported DNF/YUM-based systems. On openSUSE Tumbleweed, use the same .rpm release asset with zypper:
Future releases are included in the normal system update:
Linux FUSE mounts require fuse3, fusermount3, /dev/fuse, and a user systemd session. The package installers declare fuse3 and systemd dependencies; AppImage users may need to install those dependencies separately. The Linux artifacts include the desktop app plus loc, localityd, and the FUSE projection helper. The native package name is locality; loc is the installed command-line binary. Removing the repository definition opts the machine out of automatic package-manager discovery without removing Locality itself. An older direct package installed before repository enrollment was introduced needs this one-time reinstall. After that, the native upgrade commands above handle later releases.

​
AppImage

Use AppImage on the supported Linux distributions when you want a single-file desktop artifact with Tauri-managed self-update:

​
Windows

Download the Windows installer from the latest finalized GitHub Release:
The Windows installer includes:
  • Locality.exe;
  • loc.exe;
  • localityd.exe;
  • locality-cloud-files.exe.
After install, open Locality from the Start menu and complete onboarding.

​
Verify install

Run:
If loc is not found, open the desktop app once and complete onboarding. On macOS direct installs, Locality can install or refresh the terminal command during onboarding.

​
Release page

Use GitHub Releases for:
  • direct installers;
  • release-specific assets;
  • checksums and signatures;
  • updater manifests;
  • older versions.