Zum Inhalt springen

Datenbank

Dieser Inhalt ist für v1.0. Wechseln Sie zur neuesten Version, um die aktuelle Dokumentation zu sehen.

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.