# Mail notifications

Notifications can be sent through SMTP.

## Configuration

!!! example "File"
    ```yaml
    notif:
      mail:
        host: localhost
        port: 25
        ssl: false
        insecureSkipVerify: false
        from: diun@example.com
        to: webmaster@example.com
    ```

| Name                  | Default       | Description   |
|-----------------------|---------------|---------------|
| `host`[^1]            | `localhost`   | SMTP server host |
| `port`[^1]            | `25`          | SMTP server port |
| `ssl`                 | `false`       | SSL defines whether an SSL connection is used. Should be false in most cases since the auth mechanism should use STARTTLS |
| `insecureSkipVerify`  | `false`       | Controls whether a client verifies the server's certificate chain and hostname |
| `localName`           | `localhost`   | Hostname sent to the SMTP server with the HELO command |
| `username`            |               | SMTP username |
| `usernameFile`        |               | Use content of secret file as SMTP username if `username` not defined |
| `password`            |               | SMTP password |
| `passwordFile`        |               | Use content of secret file as SMTP password if `password` not defined |
| `from`[^1]            |               | Sender email address |
| `to`[^1]              |               | Recipient email address |

!!! abstract "Environment variables"
    * `DIUN_NOTIF_MAIL_HOST`
    * `DIUN_NOTIF_MAIL_PORT`
    * `DIUN_NOTIF_MAIL_SSL`
    * `DIUN_NOTIF_MAIL_INSECURESKIPVERIFY`
    * `DIUN_NOTIF_MAIL_LOCALNAME`
    * `DIUN_NOTIF_MAIL_USERNAME`
    * `DIUN_NOTIF_MAIL_USERNAMEFILE`
    * `DIUN_NOTIF_MAIL_PASSWORD`
    * `DIUN_NOTIF_MAIL_PASSWORDFILE`
    * `DIUN_NOTIF_MAIL_FROM`
    * `DIUN_NOTIF_MAIL_TO`

## Sample

![](../assets/notif/mail.png)

[^1]: Value required
