> ## Documentation Index
> Fetch the complete documentation index at: https://docs.locality.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Locality

> Install Locality on macOS, Linux, or Windows from package managers or GitHub release artifacts.

Install through a managed package path when possible. Use GitHub Releases when you need a direct installer, AppImage, or a specific release asset.

<Note>
  Placeholder for install demo video: install on macOS, connect Notion, open the Locality folder, and run `loc doctor`.
</Note>

## Recommended paths

| OS                          | Recommended install | Direct release asset                 |
| --------------------------- | ------------------- | ------------------------------------ |
| macOS                       | Homebrew cask       | `Locality_Mac_v<version>.dmg`        |
| Debian or Ubuntu            | APT repository      | `Locality_Linux_v<version>.deb`      |
| Fedora, RHEL, or compatible | DNF repository      | `Locality_Linux_v<version>.rpm`      |
| Linux desktop self-update   | AppImage            | `Locality_Linux_v<version>.AppImage` |
| Windows                     | GitHub installer    | `Locality_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:

```text theme={null}
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:

```bash theme={null}
brew tap codeflash-ai/tap
brew install --cask loc
```

Update:

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
sudo apt update
sudo apt upgrade loc
```

On Fedora, RHEL, or compatible distributions:

```bash theme={null}
sudo curl -fsSL -o /etc/yum.repos.d/loc.repo https://codeflash-ai.github.io/locality/rpm/loc.repo
sudo dnf install loc
```

Update:

```bash theme={null}
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:

```bash theme={null}
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:

```text theme={null}
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:

```bash theme={null}
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.

```text theme={null}
https://github.com/codeflash-ai/locality/releases
```