Documentation & Guides

Watchtower Docker — Complete Knowledge Base

Installation guides, configuration references, troubleshooting, and platform-specific setup for every Docker environment. Everything you need to master Watchtower Docker automation.

🛡️
Guide

Is Watchtower Safe? Honest Security Review

Honest 2026 safety review: the docker.sock risk, unattended-update danger for databases, and the hardening checklist — monitor-only mode, socket proxy, pinned tags.

Editorial Team8 min readOctober 2026
🧹
Config

Watchtower Cleanup: Remove Old Images After Updates

Every Watchtower update leaves the old image behind — gigabytes pile up fast. How WATCHTOWER_CLEANUP works, when to enable it, and how to reclaim disk safely.

Editorial Team6 min readOctober 2026
🔐
Config

Watchtower Private Registry Authentication

Watchtower fails on private images with 'pull access denied'? Mount your Docker config.json for GHCR, GitLab, Docker Hub and self-hosted registries — step by step.

Editorial Team7 min readOctober 2026
🆚
Compare

Watchtower vs Diun: Auto-Update or Notify?

Watchtower updates containers automatically; Diun only notifies you. Head-to-head 2026 comparison of philosophy, features and safety — plus the power combo of running both.

Editorial Team8 min readOctober 2026
⚠️
Breaking News

Is Watchtower Docker Discontinued? What Happened & What to Do (2026)

containrrr/watchtower was archived December 17, 2025. Understand what changed, whether it still works, and what to do next — including the 2-minute migration to nickfedor/watchtower.

Editorial Team7 min readJune 2026
🔀
Migration

Migrate from containrrr/watchtower to nickfedor Fork (2026) — Step-by-Step

The containrrr image is archived. Migrate to the active nickfedor/watchtower fork in under 2 minutes. Covers Docker Compose, docker run, Docker Swarm, and Portainer. Zero config changes beyond the image name.

Editorial Team4 min readJune 2026
🚀
Install

How to Install Watchtower Docker (Run, Compose, Swarm) — 2026 Guide

Complete installation guide covering Docker Run, Docker Compose, and Docker Swarm methods. First-time configuration, private registry setup, and uninstall.

Editorial Team6 min readMay 2026
⚙️
Install

Watchtower Docker Compose Setup Guide (2026)

Full Docker Compose watchtower configuration — WATCHTOWER_CLEANUP, schedules, notifications, and working compose file examples for production use.

Editorial Team8 min readMay 2026
📋
Reference

Watchtower Docker Environment Variables — Complete Configuration Reference

Every Watchtower environment variable: WATCHTOWER_CLEANUP, WATCHTOWER_SCHEDULE, WATCHTOWER_POLL_INTERVAL, notifications, private registry auth, HTTP API, and debug settings.

Editorial Team10 min readMay 2026
🔄
Config

Watchtower Docker Automatic Updates — Complete Guide

Deep-dive into the 4-step auto-update cycle — how Watchtower detects new images, stops containers, pulls updates, and restarts. Selective updates with labels.

Editorial Team7 min readMay 2026
🕐
Config

Watchtower Docker Schedule — Cron & Interval Guide

6-field cron expressions, simple polling intervals, timezone configuration, run-once mode, and HTTP API for triggering immediate updates.

Editorial Team6 min readMay 2026
🏷️
Config

Watchtower Docker Labels — Enable & Exclude Containers

Use com.centurylinklabs.watchtower.enable labels to opt containers in or out. WATCHTOWER_LABEL_ENABLE opt-in mode and per-container monitor-only labels.

Editorial Team5 min readMay 2026
🔔
Config

Watchtower Docker Notifications Setup — Slack, Email, Webhooks

Configure Slack, email SMTP, Telegram, Discord, Gotify, ntfy, and Teams via Shoutrrr URLs. Monitor-only mode for passive update alerting without restarts.

Editorial Team6 min readMay 2026
🪝
Advanced

Watchtower Lifecycle Hooks — Pre-Update & Post-Update Commands

Run commands before and after a container update with WATCHTOWER_LIFECYCLE_HOOKS and the pre-update/post-update labels, including timeout overrides.

Editorial Team6 min readJuly 2026
🌐
Advanced

Watchtower Remote Hosts & TLS — Managing a Docker Daemon You Don't Run On

Point Watchtower at a remote Docker host with DOCKER_HOST instead of the local socket, and secure the connection with TLS client certificates.

Editorial Team6 min readJuly 2026
🔌
Advanced

Watchtower HTTP API Mode — Trigger Updates On Demand

Enable the /v1/update webhook endpoint with WATCHTOWER_HTTP_API_TOKEN to trigger updates from CI right after a build, instead of waiting for the poll schedule.

Editorial Team5 min readJuly 2026
📊
Advanced

Watchtower Prometheus Metrics — Scrape Update Stats

Enable the /v1/metrics endpoint and scrape containers-scanned, updated, and failed counts into Prometheus and Grafana.

Editorial Team5 min readJuly 2026
🧩
Advanced

Running Multiple Watchtower Instances Safely — Scopes Explained

Run more than one Watchtower on the same host without them stopping each other, using WATCHTOWER_SCOPE and the scope label.

Editorial Team6 min readJuly 2026
⚡
Advanced

Watchtower Docker Advanced Usage — Private Registries, Multi-Host, Zero-Downtime

Exclude containers, authenticate ECR/GHCR/GitLab registries, monitor multiple Docker hosts, socket proxy security, rootless Docker, and multi-instance scoping.

Editorial Team8 min readMay 2026
🔁
Advanced

Watchtower Docker Force Update — Trigger Immediately, Clean Up Old Images

Immediate updates with --run-once, HTTP API for CI/CD pipelines, WATCHTOWER_CLEANUP for old image removal, and Watchtower self-update behavior.

Editorial Team5 min readMay 2026
🐝
Advanced

Watchtower Docker Swarm Support — Global Service Deploy

Deploy Watchtower as a global Docker Swarm service for cluster-wide updates. Stack YAML, rolling restarts, and Swarm-specific considerations.

Editorial Team6 min readMay 2026
🏠
Homelab

Watchtower Docker for Self-Hosted Apps — Complete Homelab Guide

Auto-update n8n, Ollama, Vaultwarden, Jellyfin, Plex, Home Assistant on any Docker host. Per-app safety ratings, exclusion guide for databases, macOS setup.

Editorial Team7 min readMay 2026
🔧
Troubleshoot

Watchtower Docker Troubleshooting — Fix Every Common Error

Fix: cannot connect to Docker daemon, containers not updating, unauthorized registry errors, keeps restarting, Docker Hub rate limits, and login failures.

Editorial Team7 min readMay 2026
🐳
Reference

Watchtower Docker Hub Images 2026 — containrrr Archived, Switch to nickfedor

containrrr/watchtower is archived (Dec 2025). Use nickfedor/watchtower instead. Image tags, comparison table, migration steps, and which image to use for your setup in 2026.

Editorial Team6 min readJune 2026
⚖️
Compare

Best Watchtower Docker Alternatives in 2026 — Post-Archive Guide

containrrr archived. Post-archive comparison: nickfedor fork, Diun, What's Up Docker, dockcheck, Portainer, and Ouroboros. Feature tables and 2026 recommendations for every use case.

Editorial Team11 min readJune 2026
📦
Platform

Watchtower Docker on Synology NAS — Full Setup Guide

Install via SSH, Docker Compose, or Container Manager GUI on DSM 7.x. Permission fixes, unhealthy container status, and Synology-specific considerations.

Editorial Team7 min readMay 2026
🖥️
Platform

Watchtower with Portainer — GUI Setup, Stack Deploy & Monitoring

Deploy Watchtower via Portainer Stacks, configure via Portainer UI, view logs in the Portainer dashboard, exclude Portainer from auto-updates.

Editorial Team6 min readMay 2026
🖥️
Platform

Watchtower Docker on Unraid — Complete Setup Guide

Community Applications install, Docker tab manual setup, or SSH. Container exclusion labels, Unraid vs Watchtower update comparison, and per-container recommendations.

Editorial Team6 min readMay 2026
🏗️
Platform

Watchtower Docker on Proxmox VE — Auto-Update Containers in LXC & VMs

Run Watchtower inside Proxmox LXC (nesting) or VMs. tteck helper scripts, Docker Compose setup, multi-LXC notification tagging, and common issues.

Editorial Team7 min readMay 2026
🍓
Platform

Watchtower Docker on Raspberry Pi — ARM Auto-Updates (Pi 4, Pi 5)

Native ARM64/arm/v7 multi-architecture support. Install on Pi OS or Ubuntu ARM, SD card optimization, ARM image availability checks, Pi homelab stack examples.

Editorial Team6 min readMay 2026
🗄️
Platform

Watchtower Docker on TrueNAS SCALE — Auto-Update Container Apps

Shell, Custom App UI, or Docker Compose on TrueNAS SCALE. SCALE vs CORE Docker differences, ZFS pool storage paths, and App catalog coexistence strategy.

Editorial Team6 min readMay 2026
🪟
Platform

Watchtower Docker on Windows — Docker Desktop Auto-Update Setup

Docker Desktop for Windows WSL2 setup, PowerShell commands, Linux containers mode requirement, auto-start on boot, and Windows credential management.

Editorial Team6 min readMay 2026
🗃️
Platform

Watchtower Docker on QNAP NAS — Container Station Setup Guide

SSH + Docker Compose or the Container Station 3 Create Application screen — no SSH required. Socket paths, permission fixes, and common QNAP-specific issues.

Editorial Team7 min readSeptember 2026
🌿
Platform

Watchtower Docker on UGREEN NAS — UGOS Setup Guide

Which DXP-series NASync models support Docker, SSH + Compose setup, and how far the built-in UGOS Container Manager app actually gets you.

Editorial Team6 min readSeptember 2026