Skip to main content
Install through a managed package path when possible. Use GitHub Releases when you need a direct installer, AppImage, or a specific release asset.
Placeholder for install demo video: install on macOS, connect Notion, open the Locality folder, and run loc doctor.
OSRecommended installDirect release asset
macOSHomebrew caskLocality_Mac_v<version>.dmg
Debian or UbuntuAPT repositoryLocality_Linux_v<version>.deb
Fedora, RHEL, or compatibleDNF repositoryLocality_Linux_v<version>.rpm
Linux desktop self-updateAppImageLocality_Linux_v<version>.AppImage
WindowsGitHub installerLocality_Windows_v<version>.exe
Release assets also include updater manifests such as latest-macos.json, latest-linux.json, and latest-windows.json, plus checksums and signatures where available. Stable latest-release URLs can use the unversioned aliases: 
https://github.com/codeflash-ai/locality/releases/latest/download/Locality_Mac.dmg
https://github.com/codeflash-ai/locality/releases/latest/download/Locality_Linux.deb
https://github.com/codeflash-ai/locality/releases/latest/download/Locality_Linux.rpm
https://github.com/codeflash-ai/locality/releases/latest/download/Locality_Linux.AppImage
https://github.com/codeflash-ai/locality/releases/latest/download/Locality_Windows.exe

​
macOS

Use Homebrew for the normal macOS install: 
brew tap codeflash-ai/tap
brew install --cask loc
Update: 
brew update
brew upgrade --cask loc
Direct download:
  1. Open the GitHub Releases page.
  2. Download the latest notarized 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

On Debian or Ubuntu: 
curl -fsSL https://codeflash-ai.github.io/locality/apt/codeflash-loc.asc | sudo gpg --dearmor -o /usr/share/keyrings/codeflash-loc.gpg
echo "deb [signed-by=/usr/share/keyrings/codeflash-loc.gpg] https://codeflash-ai.github.io/locality/apt stable main" | sudo tee /etc/apt/sources.list.d/loc.list >/dev/null
sudo apt update
sudo apt install loc
Update: 
sudo apt update
sudo apt upgrade loc
On Fedora, RHEL, or compatible distributions: 
sudo curl -fsSL -o /etc/yum.repos.d/loc.repo https://codeflash-ai.github.io/locality/rpm/loc.repo
sudo dnf install loc
Update: 
sudo dnf upgrade loc
Linux packages require fuse3 and systemd. The packages install the desktop app plus loc, localityd, and the FUSE projection helper.

​
AppImage

Use AppImage when you want the Tauri self-update channel instead of distro package updates: 
mkdir -p ~/.local/bin
curl -L -o ~/.local/bin/Locality.AppImage https://github.com/codeflash-ai/locality/releases/latest/download/Locality_Linux.AppImage
chmod +x ~/.local/bin/Locality.AppImage
~/.local/bin/Locality.AppImage

​
Windows

Download the latest Windows installer from GitHub Releases: 
Locality_Windows_v<version>.exe
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: 
loc doctor
loc daemon status
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.
https://github.com/codeflash-ai/locality/releases