Email Configuration
Set up email notifications for subscribers and alerts
Configure SMTP settings to enable email notifications for incident updates, maintenance windows, and subscriber communications.
SMTP Configuration
Add these variables to your .env file:
SMTP_HOST="smtp.example.com"
SMTP_PORT="587"
SMTP_USER="your-email@example.com"
SMTP_PASS="your-password"
SMTP_FROM="Status Page <noreply@example.com>"
SMTP_SECURE="false"
Provider Examples
Gmail
SMTP_HOST="smtp.gmail.com"
SMTP_PORT="587"
SMTP_USER="your-email@gmail.com"
SMTP_PASS="your-app-password"
SMTP_FROM="Status Page <your-email@gmail.com>"
SMTP_SECURE="false"
Gmail App Password: Gmail requires an App Password. Enable 2FA and generate one at Google Account Settings
SendGrid
SMTP_HOST="smtp.sendgrid.net"
SMTP_PORT="587"
SMTP_USER="apikey"
SMTP_PASS="SG.your-api-key"
SMTP_FROM="Status Page <noreply@yourdomain.com>"
Mailgun
SMTP_HOST="smtp.mailgun.org"
SMTP_PORT="587"
SMTP_USER="postmaster@your-domain.mailgun.org"
SMTP_PASS="your-mailgun-password"
SMTP_FROM="Status Page <noreply@your-domain.com>"
Amazon SES
SMTP_HOST="email-smtp.us-east-1.amazonaws.com"
SMTP_PORT="587"
SMTP_USER="your-ses-smtp-username"
SMTP_PASS="your-ses-smtp-password"
SMTP_FROM="Status Page <noreply@your-verified-domain.com>"
Testing Email
Test your email configuration:
- Go to Admin → Settings → Notifications
- Click Send Test Email
- Check your inbox
Email Templates
The following email templates are used:
| Template | Trigger |
|---|---|
| Incident Created | New incident reported |
| Incident Updated | Status or message changed |
| Incident Resolved | Incident marked resolved |
| Maintenance Scheduled | New maintenance window |
| Maintenance Starting | 30 minutes before start |
| Maintenance Completed | Maintenance ended |
| Subscription Confirmed | User subscribes |