SMTP

The SMTP notification provider sends HTML emails via an SMTP server. Supports TLS and optional authentication.

Configuration

Environment Variables

NOTIFIER__TYPE=smtp
NOTIFIER__SMTP__HOST=localhost
NOTIFIER__SMTP__PORT=1025
NOTIFIER__SMTP__USERNAME=root
NOTIFIER__SMTP__PASSWORD=root
[email protected]
NOTIFIER__SMTP__TLS_MODE=none
NOTIFIER__SMTP__SKIP_VERIFY_TLS=false

YAML Configuration

notifier:
  type: smtp
  smtp:
    host: localhost
    port: 1025
    username: root
    password: root
    sender: [email protected]
    tls_mode: none
    skip_verify_tls: false

Variable	Description	Default	Required
NOTIFIER__TYPE	Notification provider type	-	Yes
NOTIFIER__SMTP__HOST	SMTP server host	-	Yes
NOTIFIER__SMTP__PORT	SMTP server port	-	Yes
NOTIFIER__SMTP__USERNAME	SMTP username	-	No
NOTIFIER__SMTP__PASSWORD	SMTP password	-	No
NOTIFIER__SMTP__SENDER	From email address	-	Yes
NOTIFIER__SMTP__TLS_MODE	TLS connection mode (ssl, starttls, none)	starttls	No
NOTIFIER__SMTP__SKIP_VERIFY_TLS	Skip TLS certificate verification	false	No

warning

SKIP_VERIFY_TLS disables certificate verification. Do not use in production.

Examples

Gmail

To use Gmail, you must generate an App Password in your Google Account settings. Standard account passwords will not work.

notifier:
  type: smtp
  smtp:
    host: smtp.gmail.com
    port: 587
    username: your-[email protected]
    password: your-16-digit-app-password
    sender: your-[email protected]
    tls_mode: starttls
    skip_verify_tls: false