Server 0.4.2-rc.3 Getting Started

Use this page for 0.4.2-rc.3 deployments. New projects should normally start from the latest server quick start.

Install

Use the 0.4.2-rc.3 release artifacts from GitHub or the Docker image tag that matches your deployment policy.

curl -LO https://github.com/kalamstack/KalamDB/releases/download/v0.4.2-rc.3/kalamdb-server-0.4.2-rc.3-linux-x86_64.tar.gz
tar -xzf kalamdb-server-0.4.2-rc.3-linux-x86_64.tar.gz
./kalamdb-server

Bootstrap Auth

Check whether first-time setup is required:

curl http://127.0.0.1:8080/v1/api/auth/status

Then run setup and log in using the server auth endpoints documented in the latest auth guide.

First SQL

TOKEN="<ACCESS_TOKEN>"
 
curl -X POST http://127.0.0.1:8080/v1/api/sql \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"sql":"CREATE NAMESPACE IF NOT EXISTS app;"}'

Upgrade Path

When upgrading away from 0.4.2-rc.3, review release notes and retest auth, live subscriptions, topic consumers, and storage flush behavior in staging.