One binary. No runtime.
HeatherDB is a single self-contained executable — nothing to install alongside it, no dependency beyond libc, nothing to configure before it runs. Take the build for your machine below, or let the install script work out which one that is.
Let the script pick the build.
curl -fsSL https://heatherdb.com/install.sh | shDetects OS, architecture and libc, verifies the SHA-256 against the checksum manifest published with the release, and installs to /usr/local/bin — or ~/.local/bin when it cannot escalate. Override with HEATHER_INSTALL_DIR and HEATHER_VERSION.
irm https://heatherdb.com/install.ps1 | iexDownloads the x64 zip, verifies its hash, extracts to %LOCALAPPDATA%\Heather and appends that to your user PATH. Reopen the terminal afterwards — PATH changes only reach processes started after the change.
docker run -p 6380:6380 aphorion/heatherdb:latestMulti-arch (amd64 and arm64), signed with cosign keyless. Add a named volume or the data directory dies with the container — see getting started.
Piping a script into a shell is a decision, not a default. Both scripts are plain text on this domain — install.sh and install.ps1 — read them first if that is your habit. Neither installs anything but one binary, and neither proceeds past a checksum it cannot verify.
| Platform | Architecture | libc | File | Size | SHA-256 | Get |
|---|---|---|---|---|---|---|
macOS M1 and later. Unsigned — clear the quarantine bit on first run. | arm64 (Apple silicon) | — | heather-v1.0.0-macos-aarch64.tar.gz | 3.2 MB | 5e617f7bdc0e1272… | Download → |
macOS macOS 11+. Unsigned — clear the quarantine bit on first run. | x86_64 (Intel) | — | heather-v1.0.0-macos-x86_64.tar.gz | 3.5 MB | fe791b9a35b29f92… | Download → |
Linux Tested on Ubuntu 24.04. Use static musl on older Linux systems. | x86_64 | glibc · Ubuntu 24.04+ | heather-v1.0.0-linux-x86_64-gnu.tar.gz | 3.3 MB | 8f3376f596178d53… | Download → |
Linux Alpine, distroless, and older Linux systems. | x86_64 | musl (static) | heather-v1.0.0-linux-x86_64-musl.tar.gz | 3.3 MB | 76c46753ae388acf… | Download → |
Linux Graviton, Ampere, Raspberry Pi OS 64-bit. | aarch64 / arm64 | glibc · Ubuntu 24.04+ | heather-v1.0.0-linux-aarch64-gnu.tar.gz | 3.5 MB | 0cb2fe63311f1a71… | Download → |
Linux Alpine on ARM, and old-glibc ARM boards. | aarch64 / arm64 | musl (static) | heather-v1.0.0-linux-aarch64-musl.tar.gz | 3.6 MB | 2ccb086f475c2d96… | Download → |
Windows Windows 10 and later. ARM64 Windows runs this under emulation. | x86_64 | MSVC | heather-v1.0.0-windows-x86_64.zip | 3.2 MB | a4ba71346e854852… | Download → |
Linux Debian/Ubuntu package: systemd unit, system user, generated credentials. | amd64 | glibc · Ubuntu 24.04+ | heatherdb_1.0.0_amd64.deb | 2.3 MB | 7e00ebf616b39502… | Download → |
Linux Debian/Ubuntu package for ARM servers. | arm64 | glibc · Ubuntu 24.04+ | heatherdb_1.0.0_arm64.deb | 2.2 MB | 6ac6f2f838c2c370… | Download → |
Archives are served from GitHub releases — that is where the artefacts the CI signed actually live, and linking anywhere else would only add a hop that can go stale.
Every release ships one combined manifest. Check the archive against it before you run it — the install scripts do this for you.
curl -fsSLO https://github.com/aphorion/heatherdb/releases/download/v1.0.0/SHA256SUMS.txt sha256sum --check SHA256SUMS.txt --ignore-missing
The archive holds one directory with one binary in it. Nothing else is written to your system.
tar -xzf heather-<version>-<target>.tar.gz sudo cp heather-<version>-<target>/heather \ /usr/local/bin/ heather --version
On macOS the builds are not codesigned, so Gatekeeper holds the first run until you clear the quarantine attribute: xattr -d com.apple.quarantine /usr/local/bin/heather.
Any platform with a Rust toolchain, 1.88 or newer. This is the path for a target we do not ship, or for changing the engine.
git clone https://github.com/aphorion/heatherdb cd heather-db cargo build --release -p heather_server
One binary lands at target/release/heather.