Installation aus dem Quellcode

Pakete oder Installer gibt es noch nicht: MSI, deb, rpm und Docker-Images sind für M5 geplant. Bis dahin baust du Kalzit aus dem Quellcode. Die Schritte sind unter Windows und Linux gleich.

Was du brauchst

• Git, um den Quellcode zu holen.
• Rust, die aktuelle stabile Toolchain, installiert mit rustup. Der Server nutzt die Rust-Edition 2024.
• Node.js und npm, nur für die Weboberfläche. Die CI baut sie mit Node.js 26.

OpenSSL und ein Datenbankserver sind nicht nötig: TLS läuft über rustls, und Kalzit speichert seine eigenen Daten standardmäßig in einer SQLite-Datei.

Quellcode holen

git clone https://github.com/MouseWerk/Kalzit.git
cd Kalzit

Weboberfläche bauen

Die Weboberfläche liegt in ui/ und wird beim Bauen in das Binary eingebettet. Die Oberfläche entsteht gerade als Teil von M0. Wenn ui/ in deinem Checkout vorhanden ist, baue sie zuerst:

npm --prefix ui ci
npm --prefix ui run build

Ein Server ohne Oberfläche startet trotzdem. Browser-Anfragen beantwortet er dann mit einem kurzen Hinweis, dass die Weboberfläche nicht Teil des Builds ist; API und Health-Endpunkte funktionieren wie gewohnt.

Server bauen

cargo build --release --locked

Das Binary liegt unter Linux in target/release/kalzit, unter Windows in target\release\kalzit.exe.

Die Tests, die auch die CI unter Windows und Linux ausführt:

cargo test --locked

Starten

./target/release/kalzit

Unter Windows:

.\target\release\kalzit.exe

Ohne Konfigurationsdatei lauscht Kalzit per HTTP auf Port 3000 auf allen Schnittstellen (0.0.0.0:3000) und legt seine Daten im Ordner data im aktuellen Verzeichnis ab. Der erste Start legt die Datenbank an und schreibt einen einmaligen Einrichtungscode; was du damit machst, steht unter Erster Start.

Beenden kannst du den Server mit Strg+C (unter Linux auch mit SIGTERM). Offene Anfragen haben dann zehn Sekunden Zeit, fertig zu werden.

Befehle

Befehl	Was er tut
kalzit oder kalzit serve	Startet den Server.
kalzit check-config	Liest und prüft die Konfiguration und beendet sich dann.
kalzit --config <datei>	Nimmt diese Konfigurationsdatei statt der Standardorte. Kurzform: -c.
kalzit --version	Zeigt die Version.

Ein Fehler in der Konfiguration stoppt den Server, bevor er lauscht, mit einer Meldung, die die Einstellung nennt, und dem Exit-Code 2. Führe nach jeder Änderung kalzit check-config aus.