Dozzle : consulter les logs Docker en temps réel depuis le navigateur

Quand un container bugue à 2h du matin, la première chose que tu fais c’est docker logs -f container_name. Ça marche, mais tu dois être en SSH, tu ne peux pas voir plusieurs containers en même temps, et il n’y a aucun filtrage. Dozzle Docker est un viewer de logs en temps réel, accessible depuis le navigateur — léger, sans base de données, lecture seule.

Image de moins de 20 Mo. Exactement ce qu’il faut pour un outil de diagnostic.

Installer Dozzle Docker

services:
  dozzle:
    image: amir20/dozzle:latest
    container_name: dozzle
    restart: unless-stopped
    ports:
      - "8888:8080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      - DOZZLE_LEVEL=info
      - DOZZLE_TAILSIZE=300

Note le :ro sur le socket Docker — Dozzle n’a besoin que d’un accès en lecture. Bonne pratique de sécurité : si le container est compromis, il ne peut pas piloter Docker.

Mode multi-host

Comme Dockge, Dozzle supporte le mode agent pour voir les logs de plusieurs serveurs depuis une interface unique. Sur chaque nœud secondaire :

services:
  dozzle-agent:
    image: amir20/dozzle:latest
    command: agent
    container_name: dozzle-agent
    restart: unless-stopped
    ports:
      - "7007:7007"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro

Dans la config du nœud principal, tu pointes vers les agents. Depuis Dozzle, tu vois les logs de tes 3 nœuds dans une interface unifiée — tu peux filtrer par container, chercher une chaîne de caractères, ou ouvrir plusieurs streams en parallèle.

Ce que j’utilise vraiment

Au quotidien, Dozzle me sert principalement à trois choses : vérifier qu’un container vient de démarrer correctement après une mise à jour Watchtower, suivre les logs d’un service pendant une modification de config, et identifier rapidement quel container spamme les logs (pratique pour éviter l’usure disque inutile sur les nœuds Proxmox).

Dozzle ne remplace pas un système de centralisation de logs comme Loki/Grafana pour les setups avancés, mais pour 90% des besoins quotidiens d’un homelab, c’est suffisant et sans overhead.

Pour aller plus loin

Dozzle se complète bien avec Dockge pour la gestion des stacks. Les deux forment un duo efficace pour administrer ton infrastructure Docker sans SSH permanent. Documentation officielle : dozzle.dev.

Le bug Kometa détecté grâce à Dozzle Docker

Le cas concret qui m’a le plus servi : un bug sur Kometa qui générait des écritures massives et continues sur le NVMe, en boucle, pour rien. Sans Dozzle, j’aurais mis des jours à comprendre quelle charge disk venait de nulle part. Avec Dozzle Docker, j’ai vu les logs défiler en temps réel et identifié Kometa en moins de 2 minutes. C’est exactement ce genre de situation qui justifie d’avoir un viewer de logs toujours accessible depuis le navigateur.

👉 Pour aller plus loin : gérer ses stacks avec Dockge, automatiser les mises à jour avec Watchtower et surveiller ses services avec Uptime Kuma.