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.

⚠️
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.

Alex Chen7 min readJune 2026
🔀
Migration

Migrate from containrrr/watchtower to nickfedor Fork — 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.

Alex Chen4 min readJune 2026
🚀
Install

How to Install Watchtower Docker — Full Setup Guide

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

Alex Chen6 min readMay 2026
⚙️
Install

Watchtower Docker Compose Setup — Complete Guide

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

Alex Chen8 min readMay 2026
📋
Reference

Watchtower Docker Environment Variables — Complete Reference

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

Alex Chen10 min readMay 2026
🔄
Config

Watchtower Docker Automatic Updates — How It Works

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

Alex Chen7 min readMay 2026
🕐
Config

Watchtower Docker Schedule — Cron, Interval & Run Once

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

Alex Chen6 min readMay 2026
🏷️
Config

Watchtower Docker Labels — Enable, Exclude & Scope

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

Alex Chen5 min readMay 2026
🔔
Config

Watchtower Docker Notifications — Slack, Email, Telegram, Webhooks

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

Alex Chen6 min readMay 2026
Advanced

Watchtower Advanced Usage — Private Registry, Multi-Host, Zero-Downtime

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

Priya Sharma8 min readMay 2026
🔁
Advanced

Watchtower Docker Force Update — Trigger Now & Cleanup Images

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

Alex Chen5 min readMay 2026
🐝
Advanced

Watchtower Docker Swarm — Global Service Deploy

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

Alex Chen6 min readMay 2026
🏠
Homelab

Watchtower for Self-Hosted Apps — Homelab & n8n, Ollama

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

Jamie Lee7 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.

Alex Chen7 min readMay 2026
🐳
Reference

Watchtower Docker Hub Images 2026 — containrrr Archived, Use nickfedor Fork

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.

Alex Chen6 min readJune 2026
⚖️
Compare

Best Watchtower Docker Alternatives 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.

Priya Sharma11 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.

Jamie Lee7 min readMay 2026
🖥️
Platform

Watchtower with Portainer — GUI Stack Deploy & Monitoring

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

Marcus Carter6 min readMay 2026
🖥️
Platform

Watchtower Docker on Unraid — Auto-Update All Containers

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

Jamie Lee6 min readMay 2026
🏗️
Platform

Watchtower Docker on Proxmox — LXC & VM Auto-Updates

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

Marcus Carter7 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.

Jamie Lee6 min readMay 2026
🗄️
Platform

Watchtower Docker on TrueNAS SCALE — Auto-Update 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.

Jamie Lee6 min readMay 2026
🪟
Platform

Watchtower Docker on Windows — Docker Desktop Auto-Updates

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

Alex Chen6 min readMay 2026