Install

Quarry ships a desktop app and a CLI together. Installing either one gives you both, since the app bundles the quarry binary and calls it internally.

macOS

1. Download the .dmg from /pricing after choosing Free, Pro or Team.
2. Open it and drag Quarry to Applications.
3. Launch Quarry once. macOS will ask you to confirm the app is allowed to run, since it is signed but not sandboxed, because it needs to read arbitrary folders you choose.
4. The app installs the quarry CLI to /usr/local/bin/quarry on first launch, or to /opt/homebrew/bin/quarry on Apple Silicon if that directory already exists on your path.

A Homebrew formula is also available:

brew install --cask quarry

Linux

Quarry publishes a .deb, an .rpm, and a plain tarball. Pick whichever matches your distribution.

# Debian, Ubuntu and derivatives
sudo dpkg -i quarry_1.4.0_amd64.deb

# Fedora, RHEL and derivatives
sudo rpm -i quarry-1.4.0.x86_64.rpm

# any distribution
tar -xzf quarry-1.4.0-linux-x86_64.tar.gz
sudo mv quarry-1.4.0-linux-x86_64/quarry /usr/local/bin/

The desktop app on Linux requires a running desktop session. On a headless server, install just the CLI and daemon from the tarball and skip the app entirely.

Confirm the install

quarry --version

This should print 1.4.0 or later. If the command is not found, the install directory is not on your PATH. Add it to your shell profile:

export PATH="$PATH:/usr/local/bin"

Then check the daemon can start:

quarry status

A fresh install reports no indexes yet, which is expected. See Index your first folder for the next step.

Upgrading

Reinstalling over an existing install keeps your settings file and your indexes untouched. Neither the .deb/.rpm package managers nor the macOS installer touch ~/.config/quarry/ or ~/.local/share/quarry/.

Uninstalling

Removing the app or the package does not delete your indexes or settings. To remove everything:

rm -rf ~/.config/quarry ~/.local/share/quarry

This is destructive and cannot be undone. Your original source files are never touched, only Quarry’s own index data.