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).
Platform support
Section titled “Platform support”The CLI is a small Rust binary; we cross-compile for the same OS/arch matrix as the desktop app:
| Platform | Architecture | Binary name |
|---|---|---|
| macOS | Apple Silicon (arm64) | quay-cli_{VERSION}_aarch64-apple-darwin |
| macOS | Intel (x86_64) | quay-cli_{VERSION}_x86_64-apple-darwin |
| Windows | x64 | quay-cli_{VERSION}_x86_64-pc-windows-msvc.exe |
| Linux | x86_64 (glibc) | quay-cli_{VERSION}_x86_64-unknown-linux-gnu |
| Linux | x86_64 (musl, static) | quay-cli_{VERSION}_x86_64-unknown-linux-musl |
| Linux | aarch64 | quay-cli_{VERSION}_aarch64-unknown-linux-gnu |
Pre-built binaries
Section titled “Pre-built binaries”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:
# macOS — Apple Siliconcurl -L https://dl.quay.toko.center/quay-cli_0.1.0_aarch64-apple-darwin -o /usr/local/bin/quaychmod +x /usr/local/bin/quay
# macOS — Intelcurl -L https://dl.quay.toko.center/quay-cli_0.1.0_x86_64-apple-darwin -o /usr/local/bin/quaychmod +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/quaychmod +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/quaychmod +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/quaychmod +x /usr/local/bin/quayFor Windows (PowerShell):
Invoke-WebRequest https://dl.quay.toko.center/quay-cli_0.1.0_x86_64-pc-windows-msvc.exe -OutFile $env:LOCALAPPDATA\Programs\quay\quay.exeVerify:
quay --versionquay --helpThe 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:
shasum -a 256 -c <(curl -sS https://dl.quay.toko.center/quay-cli_0.1.0.sha256)Run the daemon as a service
Section titled “Run the daemon as a service”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.
Update
Section titled “Update”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:
# macOSlaunchctl kickstart -k gui/$(id -u)/com.unclez.quay.daemon
# Linuxsystemctl --user restart quay-daemonUninstall
Section titled “Uninstall”# Stop + unload the unit firstlaunchctl unload ~/Library/LaunchAgents/com.unclez.quay.daemon.plistrm ~/Library/LaunchAgents/com.unclez.quay.daemon.plistsudo rm /usr/local/bin/quayThe schedules.json + connections.json files belong to the desktop app — don’t delete them unless you’re uninstalling the desktop app too.