View Categories

Mailer setup

< 1 min read

EAC can send email notifications when a task/process completes — on success, error, or both.

Configuration

Edit ./shared/.env.local and set the following variables.

1. SMTP DSN

Use the DSN your app expects (usually MAILER_DSN; in some setups it may be MAIL_DSN). Keep the same key consistently everywhere.

Format (recommended):

MAILER_DSN="smtp://<LOGIN>:<PASSWORD>@<HOST>:<PORT>?encryption=<tls|ssl>&auth_mode=<login|plain>"

URL-encode special characters in <LOGIN> and <PASSWORD>.
Common encodings: @%40, :%3A, /%2F, ?%3F, #%23, &%26.

Examples:

# Port 25, no encryption
MAILER_DSN="smtp://mylogin%40mycompany.com:My%3APassword@smtp.mycompany.com:25"

# Port 587 with STARTTLS
MAILER_DSN="smtp://mylogin%40mycompany.com:MyPassword@smtp.mycompany.com:587?encryption=tls"

# Port 465 with implicit TLS (alternative)
MAILER_DSN="smtp://mylogin%40mycompany.com:MyPassword@smtp.mycompany.com:465?encryption=ssl"

Tip: wrap the value in quotes if it contains ?, &, or other special characters (safer in .env files).

2. Enable/disable the feature

APP_ENABLE_TASK_MAILER=true

Set to false anytime to stop sending emails.

3. Default recipients

# Comma-separated list; no spaces recommended APP_MAILER_DEFAULT_RECIPIENTS= »ops@mycompany.com,data-team@mycompany.com »