====== Mailrise ======

Pasarela SMTP para notificaciones de [[https://github.com/caronc/apprise|Apprise]]. Convierte los e-mails que recibe en notificaciones Apprise de tal manera que lo que llega por e-mail puede ser trasladado a los [[https://github.com/caronc/apprise?tab=readme-ov-file#supported-notifications|más de 60 servicios de notificaciones que soporta Apprise]].

  * [[https://github.com/YoRyan/mailrise|Repositorio de código]]

{{ https://raw.githubusercontent.com/YoRyan/mailrise/main/src/mailrise/asset/homelab-diagram.png |}}

===== Casos de uso =====

  * **Alertas de servidores y aplicaciones**: recibir en Telegram avisos de errores, caídas de servicios, backups fallidos, etc.
  * **Homelab y servidores domésticos**: convertir las notificaciones SMTP de servicios que no tienen integración moderna en notificaciones push.
  * **Dispositivos y aplicaciones antiguas**: sistemas que solamente permiten configurar un servidor SMTP pueden aprovechar servicios modernos de notificación.
  * **Monitorización**: herramientas como sistemas de monitorización, NAS, cámaras o servicios Docker pueden enviar alertas mediante SMTP y Mailrise encargarse de distribuirlas.
  * **Centralizar notificaciones**: múltiples aplicaciones pueden utilizar un único Mailrise y distintas direcciones de destino para seleccionar diferentes canales.
  * **Enviar a varios servicios simultáneamente**: una misma configuración de Apprise puede contener varias URLs, permitiendo enviar una alerta, por ejemplo, a Telegram y Discord al mismo tiempo.
===== Instalación =====

==== Docker ====

Ejemplo de fichero para Docker Compose:

<code yaml>
---
services:
  mailrise:
    image: yoryan/mailrise:latest
    container_name: mailrise
    restart: unless-stopped
    volumes:
      - ./app/mailrise.conf:/etc/mailrise.conf:ro
    ports:
      - 8025:8025
</code>

===== Configuración =====

Ejemplo de fichero ''mailrise.conf'' (formato YAML) para notificaciones por Telegram:

<code yaml>
configs:
  direccion@correo.ext:
    urls:
      - tgram://<BOT_TOKEN>/<CHAT_ID>
    mailrise:
      body_format: markdown
</code>

''direccion@correo.ext'' sería la cuenta a la que otra aplicación enviaría un email que luego sería capturado por Mailrise.
===== Pruebas =====

Cuando tengamos Mailrise en funcionamiento, podemos probarlo enviando un e-mail indicando el servidor en el que está instalado y el puerto por el que está escuchando.

==== Docker ====

<code>
docker run --rm -it morawskim/swaks:20240103.0 --server mailrise --port 8025 --from test@example.com --to direccion@correo.ext --header "Subject: Prueba de Mailrise" --body "Hola! Esta es una prueba de Mailrise."
</code>
==== Windows ====

Desde Powershell:

<code powershell>
Send-MailMessage -from "foo@bar.local" -to "tempwin@gmail.com" -subject "Desde Windows" -body "Foobar" -smtpserver 192.168.0.26 -port 8025
</code>

Suponiendo que Mailrise está en el servidor ''192.168.0.26'' y el puerto ''8025''.