Getting started

Concepts

Coding

Quickstarts

Guides

Recipes

Reference

CLI reference

SQL reference

SDK reference

Operations

Cloud deployment

Internals

Architecture

Design docs

Testing

Formal verification

Compliance

Resources
Kimberlite Getting started

Installation

On this page

Kimberlite ships as a single binary: kimberlite. Install it for your platform using one of the methods below.

The quickest way to install on macOS or Linux:

curl -fsSL https://kimberlite.dev/install.sh | sh

This detects your OS and architecture automatically, downloads the latest release, verifies its SHA-256 checksum against the release’s SHA256SUMS manifest, and installs kimberlite to /usr/local/bin (or ~/.kimberlite/bin if that’s not writable). A shorter alias kmb is installed alongside as a symlink. To pin a specific version: curl -fsSL https://kimberlite.dev/install.sh | sh -s -- --version v0.4.2. To bypass checksum verification (not recommended), set KIMBERLITE_SKIP_CHECKSUM=1.

macOS

Homebrew

brew install kimberlitedb/tap/kimberlite

Direct Download

# Apple Silicon (M1/M2/M3/M4)
curl -fsSL https://mac.kimberlite.dev -o kimberlite.zip
unzip kimberlite.zip && chmod +x kimberlite && sudo mv kimberlite /usr/local/bin/

# Intel Mac
curl -fsSL https://mac-intel.kimberlite.dev -o kimberlite.zip
unzip kimberlite.zip && chmod +x kimberlite && sudo mv kimberlite /usr/local/bin/

Linux

# x86_64
curl -fsSL https://linux.kimberlite.dev -o kimberlite.zip
unzip kimberlite.zip && chmod +x kimberlite && sudo mv kimberlite /usr/local/bin/

# ARM64
curl -fsSL https://linux-arm.kimberlite.dev -o kimberlite.zip
unzip kimberlite.zip && chmod +x kimberlite && sudo mv kimberlite /usr/local/bin/

Windows

Download from the download page and extract the zip. Add the directory to your PATH, then verify:

kimberlite.exe version

Docker

docker pull ghcr.io/kimberlitedb/kimberlite:latest
docker run --rm -it ghcr.io/kimberlitedb/kimberlite:latest --help

Build from Source

Requires Rust 1.88+.

git clone https://github.com/kimberlitedb/kimberlite.git
cd kimberlite
cargo build --release --bin kimberlite
sudo cp target/release/kimberlite /usr/local/bin/

Verify Installation

kimberlite version

Expected output:

kimberlite 0.4.0

Next Steps