Umgebungsvariablen
Klokk wird beim Start über Umgebungsvariablen konfiguriert. Alles, was zum laufenden Betrieb gehört – Firmen, Personen, Regeln, Löschfristen –, stellen Sie in Klokk selbst unter Admin ein, nicht hier.
Pflicht
Abschnitt betitelt „Pflicht“Ohne diese Variablen startet Klokk nicht:
| Variable | Zweck |
|---|---|
ACCEPT_TERMS Pflicht |
true akzeptiert die Nutzungsbedingungen. |
SESSION_SECRET Pflicht |
Signiert Sitzungen und Links (mindestens 32 Zeichen, zufällig). |
CSRF_KEY Pflicht |
Schützt Formulare gegen seitenübergreifende Anfragen (mindestens 32 Zeichen, zufällig). |
DATA_KEY Pflicht |
Verschlüsselt die Datenbank – nie ändern oder verlieren. |
Erzeugen Sie jeden Wert einmal mit openssl rand -hex 32, wie im Schnellstart.
Variablen setzen
Abschnitt betitelt „Variablen setzen“Mit Docker Compose stehen sie in einer env_file oder unter environment:, mit docker run über --env-file oder -e. Änderungen wirken, sobald der Container neu erstellt wird (docker compose up -d).
Geheimnisse aus Dateien
Abschnitt betitelt „Geheimnisse aus Dateien“Jede Variable kann auch aus einer Datei kommen – etwa einem Docker-Secret. <NAME>_FILE nennt die Datei, ihr Inhalt (ohne umgebende Leerzeichen) ist der Wert:
services: klokk: environment: DATA_KEY_FILE: /run/secrets/klokk_data_key SMTP_PASS_FILE: /run/secrets/smtp_pass secrets: [klokk_data_key, smtp_pass]
secrets: klokk_data_key: file: ./secrets/data_key smtp_pass: file: ./secrets/smtp_passSind NAME und NAME_FILE beide gesetzt oder ist die Datei nicht lesbar, bricht der Start ab – ein Tippfehler bleibt so nie unbemerkt.