Guides

Email

Configure delivery and send mail through the framework.

Core-managed emails use .env settings. Resend is recommended for new installs:

MAIL_SERVICE=resend
MAIL_FROM=no-reply@yourdomain.com
MAIL_FROM_NAME="Your Site Name"
RESEND_API_KEY=re_xxxxxxxxxxxx
SYSTEM_ALERT_EMAIL=alerts@example.com

SYSTEM_ALERT_EMAIL receives deduplicated fatal PHP error alerts and final job-failure alerts. If it is empty, Nimbly falls back to ADMIN_EMAIL. Alert delivery is queued, so the project scheduler must be running.

SMTP is also supported for projects that send through an SMTP provider:

MAIL_SERVICE=smtp
MAIL_FROM=no-reply@yourdomain.com
MAIL_FROM_NAME="Your Site Name"
SMTP_HOST=smtp.example.com
SMTP_PORT=465
SMTP_USER=smtp-user
SMTP_PASSWORD=smtp-password
SMTP_SECURE=smtps

SMTP_SECURE accepts smtps for implicit TLS on port 465, or starttls/tls for STARTTLS on port 587. Nimbly uses bundled PHPMailer internally as its SMTP adapter; projects configure SMTP through .env, not by calling PHPMailer directly. MAIL_SERVICE=phpmailer is accepted as a compatibility alias for older configs.


View this page as Markdown