GitHub Binaries
If you do not want Docker or a local Rust toolchain, use release artifacts from GitHub:
Each release publishes kalamdb-server and kalamcli archives, a SHA256SUMS file, and versions.json. Always verify checksums before running downloaded binaries.
What to download
From the selected release, download both the server and CLI archive for your platform, plus SHA256SUMS:
| Platform | Server archive | CLI archive |
|---|---|---|
| Linux x86_64 | kalamdb-server-<ReleaseValue bare fallback="<version>" />-linux-x86_64.tar.gz | kalamcli-<ReleaseValue bare fallback="<version>" />-linux-x86_64.tar.gz |
| Linux ARM64 | kalamdb-server-<ReleaseValue bare fallback="<version>" />-linux-aarch64.tar.gz | kalamcli-<ReleaseValue bare fallback="<version>" />-linux-aarch64.tar.gz |
| macOS Apple Silicon | kalamdb-server-<ReleaseValue bare fallback="<version>" />-macos-aarch64.tar.gz | kalamcli-<ReleaseValue bare fallback="<version>" />-macos-aarch64.tar.gz |
| Windows x86_64 | kalamdb-server-<ReleaseValue bare fallback="<version>" />-windows-x86_64.zip | kalamcli-<ReleaseValue bare fallback="<version>" />-windows-x86_64.zip |
The file names below automatically use the latest GitHub release tag. macOS Intel (x86_64) builds are not published — use Docker, build from source, or run under Rosetta with a Linux binary.
Important: binary names and config
Release archives extract to versioned filenames such as kalamdb-server-0.5.3-rc.1-linux-x86_64, not plain kalamdb-server. The server also requires a server.toml config path on startup — it will not run with zero arguments.
Start the server
# After downloading and extracting both archives into kalamdb-bin/:cd kalamdb-binln -sf kalamdb-server-0.5.4-rc.1-linux-x86_64 kalamdb-serverln -sf kalamcli-0.5.4-rc.1-linux-x86_64 kalam cat > server.toml <<'EOF'[server]host = "127.0.0.1"port = 2900 [storage]data_path = "./data" [limits] [logging]logs_path = "./logs"log_to_console = true [performance] [auth]jwt_secret = "local-binary-test-secret-32chars-min"root_password = "kalamdb123"EOF ./kalamdb-server-0.5.4-rc.1-linux-x86_64 server.tomlConfirm it is up:
Point the CLI at the same URL:
Optional: set KALAMDB_SERVER_BIN when using kalam dev in a project:
Linux example (x86_64)
sha256sum -c SHA256SUMS --ignore-missing mkdir -p kalamdb-bin && cd kalamdb-bintar -xzf ../kalamdb-server-0.5.4-rc.1-linux-x86_64.tar.gztar -xzf ../kalamcli-0.5.4-rc.1-linux-x86_64.tar.gzln -sf kalamdb-server-0.5.4-rc.1-linux-x86_64 kalamdb-serverln -sf kalamcli-0.5.4-rc.1-linux-x86_64 kalam cat > server.toml <<'EOF'[server]host = "127.0.0.1"port = 2900 [storage]data_path = "./data" [limits] [logging]logs_path = "./logs"log_to_console = true [performance] [auth]jwt_secret = "local-binary-test-secret-32chars-min"root_password = "kalamdb123"EOF ./kalamdb-server-0.5.4-rc.1-linux-x86_64 server.tomlIn another terminal:
Install onto your PATH (optional):
macOS example (Apple Silicon)
shasum -a 256 -c SHA256SUMS mkdir -p kalamdb-bin && cd kalamdb-bintar -xzf ../kalamdb-server-0.5.4-rc.1-macos-aarch64.tar.gztar -xzf ../kalamcli-0.5.4-rc.1-macos-aarch64.tar.gzln -sf kalamdb-server-0.5.4-rc.1-macos-aarch64 kalamdb-serverln -sf kalamcli-0.5.4-rc.1-macos-aarch64 kalam cat > server.toml <<'EOF'[server]host = "127.0.0.1"port = 2900 [storage]data_path = "./data" [limits] [logging]logs_path = "./logs"log_to_console = true [performance] [auth]jwt_secret = "local-binary-test-secret-32chars-min"root_password = "kalamdb123"EOF ./kalamdb-server-0.5.4-rc.1-macos-aarch64 server.toml./kalam --helpWindows example (x86_64)
Get-FileHash .\kalamdb-server-0.5.4-rc.1-windows-x86_64.zip -Algorithm SHA256Get-FileHash .\kalamcli-0.5.4-rc.1-windows-x86_64.zip -Algorithm SHA256Expand-Archive .\kalamdb-server-0.5.4-rc.1-windows-x86_64.zip -DestinationPath .Expand-Archive .\kalamcli-0.5.4-rc.1-windows-x86_64.zip -DestinationPath .@'[server]host = "127.0.0.1"port = 2900[storage]data_path = "./data"[limits][logging]logs_path = "./logs"log_to_console = true[performance][auth]jwt_secret = "local-binary-test-secret-32chars-min"root_password = "kalamdb123"'@ | Set-Content server.toml.\kalamdb-server-0.5.4-rc.1-windows-x86_64.exe server.tomlVerify and use the CLI: