Installation

kv is both a library you import and a single-binary server. The library is one go get; the server ships through every channel below.

As a library

go get github.com/tamnd/kv@latest

import "github.com/tamnd/kv"

That is the whole dependency. The module pulls in nothing outside the Go standard library, so it adds no transitive packages to your build. kv requires Go 1.23 or newer.

The server binary

The kv binary serves one store over the Redis wire protocol. Pick whichever channel suits you. Every channel installs the same static binary.

Go

go install github.com/tamnd/kv/cmd/kv@latest

Homebrew (macOS and Linux)

brew install tamnd/tap/kv

Scoop (Windows)

scoop bucket add tamnd https://github.com/tamnd/scoop-bucket
scoop install kv

Linux (apt and dnf)

A signed apt and dnf repository tracks every release, so apt upgrade and dnf upgrade keep kv current.

# Debian, Ubuntu
curl -fsSL https://tamnd.github.io/linux-repo/gpg.key \
  | sudo gpg --dearmor -o /usr/share/keyrings/tamnd.gpg
echo "deb [signed-by=/usr/share/keyrings/tamnd.gpg] https://tamnd.github.io/linux-repo/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/tamnd.list
sudo apt update && sudo apt install kv

# Fedora, RHEL
sudo dnf config-manager --add-repo https://tamnd.github.io/linux-repo/dnf/tamnd.repo
sudo dnf install kv

Release archives and Linux packages

Every release attaches tar.gz archives (and a .zip for Windows) for Linux, macOS, Windows, and FreeBSD, plus .deb, .rpm, and .apk packages and a checksums.txt with a cosign signature. Download the one for your platform, extract kv, and put it on your PATH. To install a package directly without the repository above:

# Debian/Ubuntu
sudo dpkg -i kv_*_amd64.deb

# Fedora/RHEL
sudo rpm -i kv-*.x86_64.rpm

Container

The image is a minimal base plus the static binary:

docker run -p 6379:6379 -v "$PWD/data:/data" ghcr.io/tamnd/kv \
  --port 6379 --dir /data

The store lives at /data/dump.kv on the mounted volume, so it survives across container restarts.

Verify the install

kv --version

kv 0.4.0 (1a2b3c4, built 2026-06-25T09:00:00Z)

Verify a download

Each release signs its checksums.txt with keyless cosign. To verify an archive you downloaded:

cosign verify-blob \
  --certificate checksums.txt.pem \
  --signature checksums.txt.sig \
  --certificate-identity-regexp 'https://github.com/tamnd/kv' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  checksums.txt

sha256sum -c checksums.txt --ignore-missing

Next: the quick start.