Watchtower Docker on Windows — Docker Desktop Auto-Update Setup

Prerequisites for Windows

• Windows 10 (version 2004+) or Windows 11
• Docker Desktop for Windows installed with Linux containers mode (default)
• WSL2 enabled (recommended backend) or Hyper-V
• Docker Desktop running in the system tray

Quick Install on Windows

Open PowerShell, Command Prompt, or Windows Terminal and run:

# PowerShell or Command Prompt — identical to Linux:
docker run -d `
  --name watchtower `
  --restart unless-stopped `
  -v /var/run/docker.sock:/var/run/docker.sock `
  -e WATCHTOWER_CLEANUP=true `
  -e WATCHTOWER_POLL_INTERVAL=86400 `
  containrrr/watchtower

# Verify it's running:
docker ps
docker logs watchtower

Docker Compose on Windows

# docker-compose.yml (works in any directory on Windows)
services:
  watchtower:
    image: containrrr/watchtower
    container_name: watchtower
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - WATCHTOWER_CLEANUP=true
      - WATCHTOWER_POLL_INTERVAL=86400
      - WATCHTOWER_ROLLING_RESTART=true

# Run from PowerShell or Windows Terminal:
# docker compose up -d

Save this file as docker-compose.yml in any folder on your Windows machine, then run docker compose up -d from that directory.

Running Watchtower Inside WSL2

If you primarily work inside WSL2 (Ubuntu, Debian, etc.), you can run Watchtower from within WSL2 — Docker Desktop integrates the Docker CLI into WSL2 distributions:

# Inside WSL2 terminal (Ubuntu/Debian):
docker run -d \
  --name watchtower \
  --restart unless-stopped \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e WATCHTOWER_CLEANUP=true \
  -e WATCHTOWER_SCHEDULE="0 0 4 * * *" \
  containrrr/watchtower

# The container will appear in Docker Desktop GUI as well

Auto-Start Watchtower on Windows Boot

Docker Desktop must be running for Watchtower to work. Configure Docker Desktop to start on Windows login:

1. Docker Desktop → Settings (gear icon)
2. General → Start Docker Desktop when you sign in to your computer → Enable
3. Optionally: Open Docker Dashboard at startup → Disable (to hide the UI on startup)

With --restart unless-stopped, Watchtower starts automatically when Docker Desktop starts.

Understanding the Docker Socket on Windows

Docker Desktop for Windows creates a named pipe and a Linux socket path:

# Windows named pipe (for Windows-native tools):
npipe:////./pipe/docker_engine

# Linux socket path (inside Docker Desktop VM):
/var/run/docker.sock   ← This is what Watchtower uses

# Docker Desktop also exposes the socket via:
# C:\Users\username\.docker\run\docker.sock  (Windows path to socket file)

# For Watchtower, always use:
-v /var/run/docker.sock:/var/run/docker.sock
# This works on Windows, macOS, and Linux identically

Performance Considerations on Windows

Docker Desktop on Windows runs containers inside a Linux VM (via WSL2 or Hyper-V). Container performance is slightly lower than native Linux, but Watchtower's resource usage is minimal:

# Watchtower resource usage is very low:
# - CPU: ~0% idle, brief spike during update checks
# - RAM: 15-30 MB
# - Disk I/O: minimal (only during image pulls)

# For Windows development machines, set a longer poll interval
# to avoid Docker activity interfering with development workflows:
- WATCHTOWER_SCHEDULE=0 0 3 * * *   # Update at 3 AM, not during work hours

Docker Hub Credentials on Windows

# Log into Docker Hub from any terminal on Windows:
docker login

# Docker Desktop stores credentials using Windows Credential Manager
# (not ~/.docker/config.json directly)

# To pass credentials to Watchtower:
# Method 1: Mount Docker config (may use credential store reference, not actual credentials)
-v C:\Users\username\.docker\config.json:/config.json:ro

# Method 2: Use environment variables (more reliable on Windows)
-e REPO_USER=yourusername
-e REPO_PASS=yourpassword

Viewing Logs on Windows

# In PowerShell or Windows Terminal:
docker logs watchtower
docker logs watchtower --follow
docker logs watchtower --tail 50

# In Docker Desktop GUI:
# Dashboard → watchtower container → Logs tab
# This provides a live log view with search functionality