Se você usa Docker no seu servidor ou Raspberry Pi, provavelmente já percebeu que manter seus containers atualizados pode ser uma tarefa chata e repetitiva.
A boa notícia? O Watchtower pode fazer isso automaticamente para você — e de forma agendada, sem risco de quebrar serviços.

Neste guia rápido, você vai aprender a configurar o Watchtower para executar atualizações uma vez por semana, toda quinta-feira às 04h, usando um docker-compose.yml simples e seguro.

⭐ Por que usar o Watchtower com agendamento semanal?

Atualizar containers automaticamente é ótimo, mas fazer isso todos os dias pode gerar instabilidade, principalmente em servidores que precisam ficar sempre no ar.

O ideal é programar uma janela de manutenção:

• 🕓 Horário de baixo uso
• 📅 Frequência controlada (uma vez por semana)
• 🔄 Atualizações seguras e automáticas
• 🧹 Remoção de imagens antigas com --cleanup

🚀 Arquivo docker-compose pronto (copie e cole)

version: "3.8"
services:
  watchtower:
    image: containrrr/watchtower
    container_name: watchtower
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - TZ=America/Sao_Paulo
      - WATCHTOWER_CLEANUP=true
    command: --schedule "0 4 * * 4"

🧠 Entenda o cron usado (0 4 * * 4)

O Watchtower usa uma expressão cron para o agendamento.
Vamos decodificar:

Resultado: Atualização automática toda quinta-feira às 04:00.

🔍 Como verificar se o Watchtower está rodando

Depois de subir o compose:

docker compose up -d

Use este comando para verificar o status:

docker ps | grep watchtower

E para confirmar que o cron está ativo:

docker logs watchtower

Você deve ver algo assim:

Watchtower running on schedule: 0 4 * * 4

Se aparecer → tudo funcionando!

🧪 Testar o Watchtower manualmente

Quer testar agora sem esperar quinta?

docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower --run-once

Isso faz uma verificação única e mostra possíveis updates.

❓ FAQ – Perguntas Rápidas

1. Preciso usar a tag latest para funcionar?

Sim. Containers com tags fixas como :1.0.3 não serão atualizados.

2. O Watchtower reinicia containers automaticamente?

Sim — mas somente quando existe atualização disponível.

3. Ele pode quebrar meus serviços?

Se você usa ambientes críticos, recomendo agendamento semanal (como no guia).
É mais seguro do que rodar atualizações diárias.

4. Ele remove imagens antigas?

Sim.
Isso é ativado por:

WATCHTOWER_CLEANUP=true

📌 Conclusão

Com esse docker-compose.yml, você configura uma política de atualização automática muito mais profissional:

✔️ Sem atualizações diárias arriscadas
✔️ Sem necessidade de intervenção manual
✔️ Atualização sempre em horário seguro
✔️ Servidores mais limpos e leves
✔️ Configuração ideal para home labs e produção leve