Skip to Content
🚀 KalamDB v0.3.0-alpha2 is out — Learn more
Getting StartedDocker Deployment

Docker Deployment

KalamDB provides official Docker images for quick deployment. Get a single node or full cluster running in seconds.

Single Node

KALAMDB_JWT_SECRET="$(openssl rand -base64 32)" \ curl -sSL https://kalamdb.org/docker-compose.yml | docker-compose -f - up -d

This starts a single KalamDB instance on port 8080.

3-Node Cluster

For high availability with Raft consensus:

KALAMDB_JWT_SECRET="$(openssl rand -base64 32)" \ curl -sSL https://raw.githubusercontent.com/jamals86/KalamDB/main/docker/run/cluster/docker-compose.yml | docker-compose -f - up -d

This starts a 3-node cluster with automatic leader election and data replication.

Windows PowerShell

$env:KALAMDB_JWT_SECRET = [Convert]::ToBase64String((1..32 | ForEach-Object {Get-Random -Maximum 256})) Invoke-WebRequest https://raw.githubusercontent.com/jamals86/KalamDB/main/docker/run/cluster/docker-compose.yml -UseBasicParsing | Select-Object -ExpandProperty Content | docker-compose -f - up -d

Verifying the Deployment

Once running, connect with the CLI:

kalam --host localhost --port 8080

Or check the health endpoint:

curl http://localhost:8080/health

Docker Hub

Official images are available at Docker Hub :

docker pull jamals86/kalamdb:latest
Last updated on