Email Notifications
SMTP configuration for subscriber alerts
Send email notifications to subscribers when incidents occur, maintenance is scheduled, or component status changes. Requires SMTP server configuration.
Email notifications require a working SMTP server. You can use services like SendGrid, Mailgun, Amazon SES, or your own mail server.
Overview
Email notifications allow your subscribers to receive instant updates about service status changes. Users can subscribe via the status page, and you manage the subscriber list through the admin panel.
SMTP Configuration
Step 1: Enable Email Notifications
- Navigate to Admin → Features
- Scroll to the Notifications tab
- Enable Email Notifications
Step 2: Configure SMTP Settings
Enter your SMTP server details:
| Setting | Description | Example |
|---|---|---|
| SMTP Host | Mail server hostname | smtp.sendgrid.net |
| SMTP Port | Port number (typically 587 for TLS) | 587 |
| SMTP User | Authentication username | apikey |
| SMTP Password | Authentication password or API key | (Your API key) |
| From Address | Sender email address | status@example.com |
SMTP credentials are stored encrypted in the database. Always use application-specific passwords or API keys rather than your main email password.
Common SMTP Providers
SendGrid
Host: smtp.sendgrid.net
Port: 587
User: apikey
Password: (your SendGrid API key)Mailgun
Host: smtp.mailgun.org
Port: 587
User: postmaster@your-domain.mailgun.org
Password: (your Mailgun password)Amazon SES
Host: email-smtp.us-east-1.amazonaws.com
Port: 587
User: (your SES SMTP username)
Password: (your SES SMTP password)Gmail (Not Recommended for Production)
Host: smtp.gmail.com
Port: 587
User: your-email@gmail.com
Password: (app-specific password)Gmail has strict sending limits (500/day for regular accounts). Use a dedicated email service provider for production deployments.
Subscriber Management
Manage email subscribers through the admin panel:
- View Subscribers: Admin → Subscribers
- Export List: Download subscriber list as CSV
- Remove Subscribers: Delete individual subscriptions
- Verification Status: See which emails are verified
Subscription Flow
- User enters email on status page
- Verification email sent with confirmation link
- User clicks link to confirm subscription
- User receives notifications for status changes
- Unsubscribe link included in every notification
What Triggers Email Notifications
Subscribers receive emails for:
- New Incidents: When an incident is created
- Incident Updates: When incident status changes
- Incident Resolved: When an incident is resolved
- Maintenance Scheduled: Upcoming maintenance windows
- Maintenance Started: When maintenance begins
- Maintenance Completed: When maintenance ends
Troubleshooting
Emails Not Sending
- Verify SMTP credentials are correct
- Check if your SMTP provider requires specific from addresses
- Ensure port 587 is not blocked by your firewall
- Check server logs for SMTP connection errors
Emails Going to Spam
- Set up SPF, DKIM, and DMARC records for your domain
- Use a reputable email service provider
- Ensure "From" address domain matches sending domain
- Avoid spam trigger words in subject lines