Mise à jour octobre 2026 : le projet d’origine containrrr/watchtower est archivé depuis décembre 2025 et ne fonctionne plus avec Docker Engine 29 et suivants (client API trop ancien). Le compose ci-dessous utilise le fork maintenu nicholas-fedor/watchtower, qui reprend les mêmes variables WATCHTOWER_* et les mêmes labels.
Mettre à jour ses containers Docker manuellement, c’est une tâche ingrate. Tu l’oublies, tu la repousses, et un beau jour tu te retrouves avec des images vieilles de 6 mois. Watchtower Docker règle le problème : c’est un container qui surveille tes autres containers en cours d’exécution et les met à jour automatiquement quand une nouvelle image est disponible sur le registry.
Je l’utilise sur mes 3 nœuds Proxmox depuis plusieurs mois. Résultat : je ne m’en occupe plus, et je reçois une notification Telegram à chaque mise à jour effectuée.
Comment fonctionne Watchtower Docker
Watchtower interroge le registry Docker à intervalles réguliers (par défaut toutes les 24 heures) pour chaque image utilisée par tes containers actifs. Si une nouvelle version est disponible, il pull l’image, recrée le container avec exactement les mêmes paramètres (volumes, ports, variables d’environnement), puis supprime l’ancienne image si CLEANUP=true.
C’est transparent pour les services : le downtime est minimal, quelques secondes le temps du redémarrage. Sur la plupart des containers de homelab, c’est imperceptible.
Installation
services:
watchtower:
image: ghcr.io/nicholas-fedor/watchtower:latest
container_name: watchtower
restart: unless-stopped
volumes:
- /var/run/docker.sock:/var/run/docker.sock
environment:
- TZ=Europe/Paris
- WATCHTOWER_CLEANUP=true
- WATCHTOWER_SCHEDULE=0 0 9 * * 6
- WATCHTOWER_LABEL_ENABLE=true
- WATCHTOWER_NOTIFICATIONS=shoutrrr
- WATCHTOWER_NOTIFICATION_URL=telegram://TOKEN_DU_BOT@telegram?chats=ID_DU_CHAT
labels:
- com.centurylinklabs.watchtower.enable=true
Quelques paramètres importants :
WATCHTOWER_CLEANUP=true, supprime les vieilles images après mise à jour, évite d’accumuler des Go inutiles sur le disqueWATCHTOWER_SCHEDULE, syntaxe cron étendue (6 champs, les secondes en premier). Ici : le samedi à 9hWATCHTOWER_LABEL_ENABLE=true, seuls les containers qui portent le labelcom.centurylinklabs.watchtower.enable=truesont mis à jour, Watchtower compris (d’où le label sur son propre service)WATCHTOWER_NOTIFICATIONS=shoutrrretWATCHTOWER_NOTIFICATION_URL, la notification part sur Telegram ; l’URL contient le token du bot et l’ID du chat, sur une seule ligne. Shoutrrr gère aussi Slack, Discord, Gotify, email et une dizaine d’autres services
Choisir les containers mis à jour
Par défaut, Watchtower met à jour tous les containers qui tournent. Je fais l’inverse avec WATCHTOWER_LABEL_ENABLE=true : rien n’est mis à jour sans ce label dans le compose du service.
labels:
- com.centurylinklabs.watchtower.enable=true
Home Assistant (les mises à jour HAOS se gèrent depuis l’interface HA), les bases de données et les services critiques où je préfère maîtriser la version n’ont pas ce label. La règle : si une mise à jour automatique peut casser quelque chose de difficile à réparer, pas de label. Si tu restes en mode par défaut, le label com.centurylinklabs.watchtower.enable=false exclut un container.
Pour aller plus loin
Watchtower s’intègre bien avec Dockge pour la gestion visuelle de tes stacks. Pour avoir une vue d’ensemble de ton infrastructure, consulte aussi mon setup homelab 2026. La documentation du fork maintenu est sur github.com/nicholas-fedor/watchtower.
Mon setup : Watchtower le samedi matin
Une astuce que j’ai adoptée : je lance Watchtower uniquement le samedi matin avec WATCHTOWER_SCHEDULE=0 0 9 * * 6. La logique est simple, les développeurs publient leurs releases en début de semaine, et les patches correctifs suivent dans les jours d’après. Le samedi, les images ont eu le temps de se stabiliser. La notification Telegram arrive juste après 9h, j’ai toute la matinée pour corriger si besoin.
Le petit truc en plus
Active le mode monitoring only en ajoutant WATCHTOWER_MONITOR_ONLY=true pendant une semaine avant d’activer les mises à jour auto. Tu reçois les notifications sans que rien ne change, ça permet de voir ce qui aurait été mis à jour et de vérifier qu’aucun container critique n’est dans la liste.
👉 Pour aller plus loin : gérer ses stacks avec Dockge, consulter les logs en temps réel avec Dozzle et surveiller la disponibilité avec Uptime Kuma.
FAQ
Watchtower met-il à jour tous les containers automatiquement ?
Par défaut oui. Tu peux exclure un container avec le label com.centurylinklabs.watchtower.enable=false, ou faire comme moi : WATCHTOWER_LABEL_ENABLE=true, et seuls les containers marqués com.centurylinklabs.watchtower.enable=true sont mis à jour. Dans les deux cas, laisse de côté les bases de données et Home Assistant.
Watchtower peut-il casser un service en le mettant à jour ?
C’est possible si une mise à jour introduit un breaking change. C’est pourquoi je programme Watchtower le samedi matin, les images ont eu le temps de se stabiliser après les releases en début de semaine.
Quelle est la différence entre Watchtower et Renovate/Dependabot ?
Watchtower met à jour les containers Docker en production automatiquement. Renovate/Dependabot mettent à jour les dépendances dans le code source. Ce sont deux niveaux différents, Watchtower agit sur l’infra, pas sur le code.









