Configuración de Watchtower

Consulta también la Política de Actualizaciones para decidir qué servicios etiquetar con enable=true o enable=false.

Enfoque con flags (recomendado)

En el compose actual se usan flags en command por claridad:

command:
  - --label-enable          # Solo contenedores con label enable=true
  - --cleanup               # Elimina imágenes antiguas tras actualizar
  - --schedule=0 30 3 * * * # Diario a las 03:30 (TZ del contenedor)
  - --stop-timeout=30s      # Tiempo de gracia al parar servicios

Variables de entorno (alternativa)

Equivalentes si prefieres usar environment:

WATCHTOWER_LABEL_ENABLE=true
WATCHTOWER_CLEANUP=true
WATCHTOWER_SCHEDULE=0 30 3 * * *
WATCHTOWER_TIMEOUT=30s

Ejemplo:

environment:
  - TZ=Europe/Madrid
  - WATCHTOWER_LABEL_ENABLE=true
  - WATCHTOWER_CLEANUP=true
  - WATCHTOWER_SCHEDULE=0 30 3 * * *
  - WATCHTOWER_TIMEOUT=30s

Compose de referencia (flags)

services:
  watchtower:
    image: containrrr/watchtower:latest
    container_name: watchtower
    restart: unless-stopped
    environment:
      - TZ=Europe/Madrid
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    command:
      - --label-enable
      - --cleanup
      - --schedule=0 30 3 * * *
      - --stop-timeout=30s

Etiquetado de servicios

labels:
  - "com.centurylinklabs.watchtower.enable=true"

Solo los servicios con com.centurylinklabs.watchtower.enable=true se actualizarán.

Buenas prácticas

Programa en horas de baja actividad (madrugada)
Mantén backups en servicios con estado
Revisa logs tras actualizaciones
Excluye servicios críticos si prefieres actualizarlos manualmente (enable=false)

Última actualización: Nov 2025 (horario 03:30 y flags)