š 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 guide.
| Variable | Description | Required? | Default |
|---|---|---|---|
| EMAIL_SMTP_HOST | Hostname of email server | ||
| EMAIL_SMTP_PORT | Port of email server | 587 | |
| EMAIL_SMTP_SECURE | Secure connection | true | |
| EMAIL_SMTP_USER | Auth user | ||
| 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 | ||
| 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 |
EMAIL_SMTP_PASSWORD or EMAIL_SMTP_ACCESS_TOKEN needs to be provided