Installation

Keyraft can be installed via Docker, install script, pre-built binaries, or from source.

Docker (Recommended)

docker run -d -p 7200:7200 \
  -e KEYRAFT_MASTER_KEY=$(openssl rand -base64 32) \
  -v keyraft-data:/data \
  keyraft/keyrafted:latest

Docker images:

• Docker Hub: keyraft/keyrafted
• GitHub Container Registry: ghcr.io/keyraft/keyrafted:latest - View Packages

The container automatically initializes on first run. Get the root token from logs:

docker logs <container-name>

Look for the Root token message in the output.

Install Script

curl -fsSL https://raw.githubusercontent.com/keyraft/keyrafted/main/install.sh | sh

Pre-built Binaries

Download from GitHub Releases:

# Linux
wget https://github.com/keyraft/keyrafted/releases/latest/download/keyrafted-linux-amd64
chmod +x keyrafted-linux-amd64
sudo mv keyrafted-linux-amd64 /usr/local/bin/keyrafted

# macOS
wget https://github.com/keyraft/keyrafted/releases/latest/download/keyrafted-darwin-amd64
chmod +x keyrafted-darwin-amd64
sudo mv keyrafted-darwin-amd64 /usr/local/bin/keyrafted

From Source

go install github.com/keyraft/keyrafted@latest

Verify Installation

After installation, initialize and start the server - see Quick Start.

keyrafted init --data-dir ./data
export KEYRAFT_MASTER_KEY=$(openssl rand -base64 32)
keyrafted start --data-dir ./data --listen :7200

Then check health:

curl http://localhost:7200/v1/health