Datenbank

Variable	Standard	Beschreibung
DB_DRIVER	sqlite	Datenbank-Backend: sqlite oder postgres.
DB_SQLITE_PATH	data/klokk.db	Pfad zur SQLite-Datei. Der Standard liegt in /app/data, dem Container-Volume — einbinden, damit die Datenbank Updates übersteht. Eine klokk.db am früheren Standardort (Arbeitsverzeichnis) wird weiterverwendet, falls vorhanden.
DB_DSN	—	PostgreSQL-Verbindungszeichenfolge, z. B. postgres://user:pass@host:5432/db?sslmode=disable. Erforderlich bei DB_DRIVER=postgres.
DB_MAX_OPEN_CONNS	25	Maximale offene DB-Verbindungen (nur PostgreSQL).
DB_MAX_IDLE_CONNS	5	Maximale ungenutzte DB-Verbindungen (nur PostgreSQL).
DB_CONN_MAX_LIFETIME_MINUTES	5	Maximale Verbindungslebensdauer in Minuten (nur PostgreSQL).

Update-Hinweis — SQLite ohne DB_SQLITE_PATH

Images vor v1.0.0 legten die Datenbank unter /app/klokk.db ab, also außerhalb des Volumes. Wer Klokk per Schnellstart ohne DB_SQLITE_PATH betreibt, kopiert die Datenbank vor dem Update einmalig ins Volume — am besten, wenn gerade niemand stempelt:

docker exec klokk sh -c '[ -f /app/klokk.db ] && [ ! -e /app/data/klokk.db ] && cp -p /app/klokk.db /app/data/klokk.db && echo copied'

Mit Docker Compose docker compose exec klokk … verwenden. Danach wie gewohnt aktualisieren; die neue Version nutzt /app/data/klokk.db. Installationen, die bereits DB_SQLITE_PATH=/app/data/klokk.db setzen, müssen nichts tun.