Skip to content

Install the CLI

Latest release is v0.1.0 (the version is auto-fetched from /v1/releases at build time — every URL below always points at the most recent build).

The CLI is a small Rust binary; we cross-compile for the same OS/arch matrix as the desktop app:

PlatformArchitectureBinary name
macOSApple Silicon (arm64)quay-cli_{VERSION}_aarch64-apple-darwin
macOSIntel (x86_64)quay-cli_{VERSION}_x86_64-apple-darwin
Windowsx64quay-cli_{VERSION}_x86_64-pc-windows-msvc.exe
Linuxx86_64 (glibc)quay-cli_{VERSION}_x86_64-unknown-linux-gnu
Linuxx86_64 (musl, static)quay-cli_{VERSION}_x86_64-unknown-linux-musl
Linuxaarch64quay-cli_{VERSION}_aarch64-unknown-linux-gnu

The CLI ships pre-built starting with the next desktop release. Until then the daemon path is invite-only — file a request via the desktop app’s Settings → Feedback (“send me a v0.1 CLI build”) and you’ll get a signed binary by email along with verification instructions.

Once they ship, install with the right binary for your platform:

Terminal window
# macOS — Apple Silicon
curl -L https://dl.quay.toko.center/quay-cli_0.1.0_aarch64-apple-darwin -o /usr/local/bin/quay
chmod +x /usr/local/bin/quay
# macOS — Intel
curl -L https://dl.quay.toko.center/quay-cli_0.1.0_x86_64-apple-darwin -o /usr/local/bin/quay
chmod +x /usr/local/bin/quay
# Linux — x86_64 (glibc — Ubuntu / Debian / Fedora / RHEL)
curl -L https://dl.quay.toko.center/quay-cli_0.1.0_x86_64-unknown-linux-gnu -o /usr/local/bin/quay
chmod +x /usr/local/bin/quay
# Linux — x86_64 (musl / static — Alpine, containers, anything without glibc)
curl -L https://dl.quay.toko.center/quay-cli_0.1.0_x86_64-unknown-linux-musl -o /usr/local/bin/quay
chmod +x /usr/local/bin/quay
# Linux — aarch64 (Raspberry Pi 4/5, AWS Graviton, Asahi)
curl -L https://dl.quay.toko.center/quay-cli_0.1.0_aarch64-unknown-linux-gnu -o /usr/local/bin/quay
chmod +x /usr/local/bin/quay

For Windows (PowerShell):

Terminal window
Invoke-WebRequest https://dl.quay.toko.center/quay-cli_0.1.0_x86_64-pc-windows-msvc.exe -OutFile $env:LOCALAPPDATA\Programs\quay\quay.exe

Verify:

Terminal window
quay --version
quay --help

The binary is ~7.5 MB on macOS arm64, slightly larger on Linux x86_64. No runtime dependencies — sqlx + redis are statically linked via rustls.

Each release ships with a SHA-256 sidecar:

Terminal window
shasum -a 256 -c <(curl -sS https://dl.quay.toko.center/quay-cli_0.1.0.sha256)

This is what you almost certainly want — the daemon should restart on login and survive crashes. See launchd / systemd unit for the full plist + service file you can copy in.

When a new release lands, re-run the install one-liner above (the URLs follow whatever’s latest at /v1/releases — the docs you’re reading were built against v0.1.0). Then bounce the daemon:

Terminal window
# macOS
launchctl kickstart -k gui/$(id -u)/com.unclez.quay.daemon
# Linux
systemctl --user restart quay-daemon
Terminal window
# Stop + unload the unit first
launchctl unload ~/Library/LaunchAgents/com.unclez.quay.daemon.plist
rm ~/Library/LaunchAgents/com.unclez.quay.daemon.plist
sudo rm /usr/local/bin/quay

The schedules.json + connections.json files belong to the desktop app — don’t delete them unless you’re uninstalling the desktop app too.