groales/watchtower
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Page: Notificaciones
Pages
Configuracion Home Notificaciones Politica Actualizaciones Troubleshooting
Clone
7
Notificaciones
groales edited this page 2025-12-02 19:24:50 +01:00
Table of Contents

Notificaciones con Shoutrrr

Watchtower integra Shoutrrr, permitiendo enviar avisos a múltiples destinos.

Configuración

Las notificaciones se configuran mediante variables de entorno en docker-compose.yml.

Ejemplo básico:

environment:
  - TZ=Europe/Madrid
  - DOCKER_API_VERSION=1.44
  - WATCHTOWER_NOTIFICATIONS=shoutrrr
  - WATCHTOWER_NOTIFICATION_URL=smtp://servidor:25/?from=noreply@midominio.com&to=admin@midominio.com
  - WATCHTOWER_NOTIFIER_LEVEL=info
  - WATCHTOWER_NOTIFICATIONS_REPORT=true

Después de modificar, reinicia el contenedor:

docker compose up -d

Variables principales

  • WATCHTOWER_NOTIFICATIONS=shoutrrr - Activar notificaciones
  • WATCHTOWER_NOTIFICATION_URL=<url> - URL del servicio (separa varias con ;)
  • WATCHTOWER_NOTIFIER_LEVEL=info - Nivel de log (panic, fatal, error, warn, info, debug, trace)
  • WATCHTOWER_NOTIFICATIONS_REPORT=true - Enviar reporte final con resumen

Ejemplos de Notificaciones

Email SMTP sin autenticación (puerto 25)

Ideal para servidores relay internos o Microsoft 365 Mail Protection:

environment:
  - TZ=Europe/Madrid
  - DOCKER_API_VERSION=1.44
  - WATCHTOWER_NOTIFICATIONS=shoutrrr
  - WATCHTOWER_NOTIFICATION_URL=smtp://mail.midominio.com:25/?from=noreply@midominio.com&to=admin@midominio.com&subject=Watchtower%20-%20Actualizaciones
  - WATCHTOWER_NOTIFIER_LEVEL=info
  - WATCHTOWER_NOTIFICATIONS_REPORT=true

Microsoft 365 Mail Protection

Microsoft 365 permite recibir correos desde servidores externos mediante conectores de entrada:

Formato del endpoint:

tudominio-com.mail.protection.outlook.com

(Reemplaza los puntos del dominio por guiones)

Ejemplo de configuración:

environment:
  - TZ=Europe/Madrid
  - DOCKER_API_VERSION=1.44
  - WATCHTOWER_NOTIFICATION_URL=smtp://midominio-com.mail.protection.outlook.com:25/?from=noreply@midominio.com&to=admin@midominio.com&subject=Watchtower%20-%20Actualizaciones

Requisitos previos en Microsoft 365:

  1. Crear conector de entrada en Exchange Admin Center
  2. Configurar IP del servidor Docker en lista de IPs autorizadas
  3. Configurar dominio remitente (si es necesario)

Características:

  • Puerto 25 (no requiere TLS/STARTTLS)
  • Sin autenticación (basada en IP)
  • Solo acepta correos desde IPs configuradas
  • Ideal para entornos corporativos con Microsoft 365

Email SMTP con autenticación (puerto 587)

Para servidores que requieren usuario/contraseña:TP con autenticación (puerto 587)

Para servidores que requieren usuario/contraseña:

environment:
  - TZ=Europe/Madrid
  - DOCKER_API_VERSION=1.44
  - WATCHTOWER_NOTIFICATIONS=shoutrrr
  - WATCHTOWER_NOTIFICATION_URL=smtp://USUARIO:PASS@smtp.example.com:587/?from=watchtower@midominio.com&to=ops@midominio.com&subject=Watchtower%20Actualizaciones&starttls=Yes
  - WATCHTOWER_NOTIFIER_LEVEL=info
  - WATCHTOWER_NOTIFICATIONS_REPORT=true

Notas:

  • Escapa caracteres especiales en USUARIO/PASS si es necesario
  • Puerto 587: STARTTLS (usa starttls=Yes)
  • Puerto 465: SSL/TLS directo (usa encryption=ssl)

Telegram

WATCHTOWER_NOTIFICATIONS=shoutrrr
WATCHTOWER_NOTIFICATION_URL=telegram://TOKEN@CHATID

Slack

WATCHTOWER_NOTIFICATIONS=shoutrrr
WATCHTOWER_NOTIFICATION_URL=slack://TOKEN@CHANNEL

Email (SMTP)

Ejemplo con STARTTLS (puerto 587):

WATCHTOWER_NOTIFICATIONS=shoutrrr
WATCHTOWER_NOTIFICATION_URL=smtp://USUARIO:PASS@smtp.example.com:587/?from=watchtower@midominio.com&to=ops@midominio.com&subject=Watchtower%20Actualizaciones&starttls=Yes
WATCHTOWER_NOTIFIER_LEVEL=info
WATCHTOWER_NOTIFICATIONS_REPORT=true

Notas:

  • Escapa caracteres especiales en USUARIO/PASS si es necesario.
  • Cambia starttls=Yes/puerto según tu servidor (SSL/TLS puro suele ser 465).

Varios destinatarios (SMTP)

Separados por coma en el parámetro to:

WATCHTOWER_NOTIFICATION_URL=smtp://USUARIO:PASS@smtp.example.com:587/?from=watchtower@midominio.com&to=ops@midominio.com,devops@midominio.com&subject=Watchtower%20Actualizaciones&starttls=Yes

Múltiples destinos (p.ej. SMTP + Telegram)

Separa URLs con ;:

WATCHTOWER_NOTIFICATION_URL=smtp://USUARIO:PASS@smtp.example.com:587/?from=watchtower@midominio.com&to=ops@midominio.com&subject=Watchtower%20Actualizaciones&starttls=Yes;telegram://TOKEN@CHATID

Filtrado

  • WATCHTOWER_NOTIFIER_LEVEL=info|debug|warn|error
  • WATCHTOWER_NOTIFICATIONS_REPORT=true para informes al finalizar

Consejos

  • Prueba primero con un único destino
  • Usa debug para validar formatos

Última actualización: Nov 2025