Docker Deployment
KalamDB ships maintained Compose files in the main repository.
Single Node
curl -sSL https://raw.githubusercontent.com/kalamstack/KalamDB/main/docker/run/single/docker-compose.yml -o docker-compose.ymlKALAMDB_JWT_SECRET="$(openssl rand -base64 32)" docker compose up -dBy default, this maps host 2900 -> container 2900.
3-Node Cluster
curl -sSL https://raw.githubusercontent.com/kalamstack/KalamDB/main/docker/run/cluster/docker-compose.yml -o docker-compose.cluster.ymlKALAMDB_JWT_SECRET="$(openssl rand -base64 32)" docker compose -f docker-compose.cluster.yml up -dDefault host ports:
- node1 API:
8081 - node2 API:
8082 - node3 API:
8083
Windows PowerShell
$env:KALAMDB_JWT_SECRET = [Convert]::ToBase64String((1..32 | ForEach-Object { Get-Random -Maximum 256 }))Invoke-WebRequest https://raw.githubusercontent.com/kalamstack/KalamDB/main/docker/run/single/docker-compose.yml -UseBasicParsing -OutFile docker-compose.ymldocker compose up -dVerify Deployment
curl http://localhost:8088/v1/api/healthcheckkalam --host localhost --port 8088Admin UI:
http://localhost:8088/uiNotes
- Keep
KALAMDB_JWT_SECRETnon-default in shared environments. - For first login/setup in Docker, review Authentication & Bootstrap.
- For OIDC issuer trust, review OIDC & Issuer Trust.
- For Firebase-specific setup, review Firebase.
- For Keycloak-specific setup, review Keycloak.
- For local S3-compatible object storage, review MinIO (S3-Compatible).
- For Jaeger setup, review Jaeger.
- For distributed tracing with Jaeger, review OpenTelemetry (OTEL).
- Official image: jamals86/kalamdb on Docker Hub
Last updated on