Docker-Images

Klokk gibt es als Docker-Image, gleichwertig in zwei Registries:

Registry	Image
Docker Hub	klokkme/klokk
GitHub Container Registry	ghcr.io/klokk-me/klokk

Tags

Tag	Beschreibung
stable	Die aktuelle Version. Empfohlen für den Self-Hosting-Betrieb.
latest	Identisch mit stable.
1.2.3	Eine exakte Version (X.Y.Z). Für reproduzierbare Installationen fest eintragen und bewusst aktualisieren – was sich geändert hat, steht im Changelog.
1.2	Folgt den Patch-Versionen einer Minor-Version (X.Y), ohne neue Funktionen zu übernehmen. Mit der nächsten Minor-Version bleibt der Tag stehen.

Sicherheit der Images

Die Images enthalten nur das Programm, seine Dateien und die CA-Zertifikate – kein Betriebssystem, keine Shell, keine Werkzeuge. Alle Dateien gehören root und sind für Klokk nicht änderbar; Klokk läuft als Benutzer 1001 und schreibt nur nach /app/data und /tmp. Der Healthcheck ist im Image enthalten. Die Container wie in den Beispielen gehärtet starten: read_only: true, ein /tmp-tmpfs, cap_drop: [ALL] und no-new-privileges; Geheimnisse möglichst als Datei übergeben (<NAME>_FILE).

Neue Versionen erkennen

Bei der täglichen Lizenzprüfung erfährt Klokk die neueste veröffentlichte Version; die Angabe ist signiert und wird nur dann übernommen. Ist sie neuer als die installierte, zeigt die Versionsangabe im Seitenfuß für Admins den Hinweis „Update“.

Der Hinweis führt zu „Was ist neu“: Dort stehen über der installierten Version die Änderungen der neuen Version – mit Erklärung und Link zur Dokumentation, Handlungsbedarf zuerst. Diese Versionshinweise lädt Klokk erst beim Öffnen der Seite von https://klokk.me/api/releases, ohne Angaben zur Installation, und hält sie eine Stunde vor. Ist klokk.me nicht erreichbar, verlinkt die Seite stattdessen auf klokk.me/changelog.