Container-Aktionen

Docker Only

Dozzle unterstützt Container-Aktionen: Über das Dropdown-Menü rechts neben den Container-Statistiken kannst du Container starten, stoppen, neu starten (restart), entfernen (remove) und aktualisieren (update). Diese Funktion ist standardmäßig deaktiviert und lässt sich aktivieren, indem du die Umgebungsvariable DOZZLE_ENABLE_ACTIONS auf true setzt.

Die Aktion update lädt das neueste Image für den Container und erstellt ihn mit derselben Konfiguration neu — praktisch, um einen Container an Ort und Stelle zu aktualisieren, ohne seine Compose-Datei zu bearbeiten. update hat nur dann einen spürbaren Effekt, wenn das Image ein bewegliches Tag nutzt (z. B. latest, stable); bei einem fest gepinnten Tag wird schlicht dasselbe Image erneut geladen.

WARNING

remove und update erstellen den Container neu. Daten in anonymen Volumes oder in der beschreibbaren Schicht des Containers gehen dabei verloren. Benannte Volumes und Bind-Mounts bleiben erhalten.

sh

docker run --volume=/var/run/docker.sock:/var/run/docker.sock -p 8080:8080 amir20/dozzle --enable-actions

docker-compose.yml

services:
  dozzle:
    image: amir20/dozzle:latest
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    ports:
      - 8080:8080
    environment:
      DOZZLE_ENABLE_ACTIONS: true

Update-Prüfung

Dozzle prüft, ob das Image, das ein Container ausführt, noch dasselbe ist, das seine Registry ausliefert. Weichen sie voneinander ab, erscheint ein Punkt am Container-Menü und das Menü weist auf ein verfügbares Update hin.

Die Prüfung fragt bei der Registry den Digest des Tags ab, aus dem der Container erstellt wurde, und vergleicht ihn mit dem Digest, den der Container tatsächlich ausführt. Das passiert über eine HEAD-Anfrage auf das Image-Manifest, es werden also keine Layer heruntergeladen und es zählt nicht gegen die Pull-Limits von Docker Hub. Antworten werden sechs Stunden zwischengespeichert, und dasselbe Image wird immer nur einmal abgefragt, egal wie viele Container oder Hosts es ausführen.

Da gegen das verglichen wird, was der Container ausführt, gilt ein Container so lange als veraltet, bis er neu erstellt wird, selbst wenn ein neueres Image bereits auf den Host geladen wurde.

Die Prüfung ist unabhängig von den Aktionen. Zu wissen, dass ein Container veraltet ist, ist nützlich, egal ob Dozzle etwas dagegen unternehmen darf oder nicht, der Hinweis erscheint also auch, wenn DOZZLE_ENABLE_ACTIONS aus ist. Nur die Schaltfläche Update setzt Aktionen voraus.

Abschalten

DOZZLE_IMAGE_CHECK_MODE steuert, ob Dozzle überhaupt Registries kontaktiert.

Wert	Verhalten
automatic	Prüft im Hintergrund, sobald ein Container angesehen wird.
manual	Prüft nie von selbst. Das Menü bietet die Aktion "Nach Updates suchen" an.
off	Die Funktion ist weg. Es wird kein Endpunkt registriert und es werden keine Anfragen gestellt.

Standardmäßig übernimmt sie den Wert von DOZZLE_RELEASE_CHECK_MODE. Wenn du Dozzle also schon gesagt hast, dass es Releases nicht automatisch abrufen soll, prüft es auch Images nicht automatisch.

services:
  dozzle:
    image: amir20/dozzle:latest
    environment:
      DOZZLE_IMAGE_CHECK_MODE: off

Um einen einzelnen Container ruhigzustellen, etwa einen bewusst auf eine Version gepinnten, versiehst du ihn mit einem Label:

services:
  database:
    image: postgres:18-alpine
    labels:
      dev.dozzle.update-check: false

Bei einem gefundenen Update kann auch eine Benachrichtigung erscheinen. Sie ist standardmäßig aus und findet sich unter den Einstellungen.

Was sich nicht prüfen lässt

Bei manchen Containern gibt es nichts zu vergleichen, und Dozzle bleibt still statt zu raten:

• Lokal gebaute Images, die keinen Registry-Digest tragen
• Referenzen, die auf einen Digest gepinnt sind und sich daher nicht verändern können
• Private Registries, da Dozzle keine eigenen Zugangsdaten hat
• Kubernetes, wo das Ausrollen von Images Sache des Clusters ist

Dozzle selbst aktualisieren

Dozzle kann sich nicht selbst stoppen, um sich an Ort und Stelle zu aktualisieren, deshalb zeigt ein eigenständiger Dozzle-Container den Update-Hinweis mit einem Link zu den Release Notes statt einer Update-Schaltfläche. Läuft Dozzle als Swarm-Service, funktioniert es normal, da das Update an den Orchestrator übergeben wird. Dozzle-Agents auf anderen Hosts sind gewöhnliche Container und aktualisieren sich wie alles andere.