> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lightdash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure SMTP for Lightdash email notifications

<Note>
  🛠 This page is for engineering teams self-hosting their own Lightdash instance. If you want to set up scheduled deliveries and alerts, go to the [Scheduled deliveries](/guides/how-to-create-scheduled-deliveries) guide.
</Note>

This is a reference to all the SMTP environment variables that can be used to configure a Lightdash email client.

| Variable                          | Description                                                                                                                                                                              |                   Required?                   | Default |
| :-------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------: | :-----: |
| EMAIL\_SMTP\_HOST                 | Hostname of email server                                                                                                                                                                 | <Icon icon="square-check" iconType="solid" /> |         |
| EMAIL\_SMTP\_PORT                 | Port of email server                                                                                                                                                                     |                      587                      |         |
| EMAIL\_SMTP\_SECURE               | Secure connection                                                                                                                                                                        |                      true                     |         |
| EMAIL\_SMTP\_USER                 | Auth user                                                                                                                                                                                | <Icon icon="square-check" iconType="solid" /> |         |
| EMAIL\_SMTP\_PASSWORD             | Auth password                                                                                                                                                                            |                      \[1]                     |         |
| EMAIL\_SMTP\_ACCESS\_TOKEN        | Auth access token for Oauth2 authentication                                                                                                                                              |                      \[1]                     |         |
| EMAIL\_SMTP\_ALLOW\_INVALID\_CERT | Allow connection to TLS server with self-signed or invalid TLS certificate                                                                                                               |                     false                     |         |
| EMAIL\_SMTP\_SENDER\_EMAIL        | The email address that sends emails                                                                                                                                                      | <Icon icon="square-check" iconType="solid" /> |         |
| EMAIL\_SMTP\_SENDER\_NAME         | The name of the email address that sends emails                                                                                                                                          |                   Lightdash                   |         |
| EMAIL\_SMTP\_IMAGE\_INLINE\_CID   | Embed images directly into emails as CID attachments instead of referencing external URLs. Useful for deployments behind firewalls where email clients cannot reach internal image URLs. |                     false                     |         |

\[1] `EMAIL_SMTP_PASSWORD` or `EMAIL_SMTP_ACCESS_TOKEN` needs to be provided