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.

🚀
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 — containrrr vs nickfedor

Official containrrr/watchtower vs nickfedor fork. Image tags (latest, edge, versioned), multi-arch (amd64/arm64/arm/v7) and which image to use for your setup.

Alex Chen5 min readMay 2026
⚖️
Compare

Watchtower Alternatives — Diun, What's Up Docker, Ouroboros

Full comparison: Watchtower vs Ouroboros, Diun, What's Up Docker, and Portainer. Feature tables, use-case recommendations, and when to switch alternatives.

Priya Sharma9 min readMay 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