Erster Start

Solange es keinen Benutzer gibt, ist Kalzit im Einrichtungsmodus. Nur wer den Server betreibt, kann die Einrichtung abschließen, denn der Einrichtungscode landet in einer Datei auf dem Server, nie im Log.

Der Einrichtungscode

Beim ersten Start erzeugt Kalzit einen Zufallscode und schreibt ihn in setup-token.txt im Datenverzeichnis (standardmäßig data/setup-token.txt). Unter Linux kann nur der Benutzer, unter dem der Server läuft, die Datei lesen. Das Log nennt die Datei, nicht den Code:

first start: open Kalzit in the browser and enter the setup code from data/setup-token.txt

Der Code sieht aus wie 3f9a-07c2-… und hat sechs Gruppen zu je vier Zeichen. Bindestriche, Leerzeichen sowie Groß- und Kleinschreibung spielen beim Eintippen keine Rolle.

Organisation und Eigentümer anlegen

Öffne Kalzit im Browser (standardmäßig http://localhost:3000) und gib ein:

• den Einrichtungscode,
• den Namen deiner ersten Organisation,
• deinen Namen und deine E-Mail-Adresse,
• ein Passwort mit mindestens 12 Zeichen.

Kalzit legt die Organisation an, macht dich zu ihrem Eigentümer und zum Server-Admin und meldet dich an. Danach löscht es setup-token.txt; der Einrichtungsmodus ist endgültig vorbei. Wiederholte falsche Codes werden pro Client-Adresse gebremst.

Die Einrichtungsseite gehört zum Grundgerüst der Oberfläche, das in M0 entsteht. Solange sie nicht in deinem Build ist, nimm die API.

Einrichtung per API

GET /api/setup antwortet {"needed": true}, solange die Einrichtung offen ist. Zum Abschließen:

curl -X POST http://localhost:3000/api/setup \
  -H "Content-Type: application/json" \
  -d '{"token": "<Einrichtungscode>", "orgName": "Beispiel", "name": "Dein Name", "email": "du@example.com", "password": "<mindestens 12 Zeichen>"}'

Die Antwort setzt das Sitzungs-Cookie und liefert deinen Benutzer mit seinen Organisationen.

Automatische Installationen

Für Skripte und Tests kannst du vor dem ersten Start KALZIT_SETUP_TOKEN auf einen eigenen Code setzen. Kalzit nimmt dann diesen Code und schreibt keine Datei. Sobald es einen Benutzer gibt, hat die Variable keine Wirkung mehr.

Prüfen, ob er läuft

Zwei Endpunkte antworten ohne Anmeldung, für Dienstverwaltung, Load Balancer und Container:

Endpunkt	Antwort
/healthz	ok, solange der Prozess läuft.
/readyz	ready, wenn die Datenbank antwortet, sonst Status 503.