Skip to main content

Email

duplistatus supports sending email notifications via SMTP as an alternative or complement to NTFY notifications. Email configuration is now managed through the web interface with encrypted storage in the database for enhanced security.

Email Configuration

SettingDescription
SMTP Server HostYour email provider's SMTP server (e.g., smtp.gmail.com).
SMTP Server PortPort number (typically 25 for Plain SMTP, 587 for STARTTLS, or 465 for Direct SSL/TLS).
Connection TypeSelect between Plain SMTP, STARTTLS, or Direct SSL/TLS. Defaults to Direct SSL/TLS for new configurations.
SMTP AuthenticationToggle to enable or disable SMTP authentication. When disabled, username and password fields are not required.
SMTP UsernameYour email address or username (required when authentication is enabled).
SMTP PasswordYour email password or app-specific password (required when authentication is enabled).
Sender NameDisplay name shown as the sender in email notifications (optional, defaults to "duplistatus").
From AddressEmail address shown as the sender. Required for Plain SMTP connections or when authentication is disabled. Defaults to SMTP username when authentication is enabled. Note that some email providers will override the From Address with the SMTP Server Username.
Recipient EmailThe email address to receive notifications. Must be a valid email address format.

A green icon next to Email in the sidebar means your settings are valid. If the icon is yellow, your settings are not valid or not configured.

The icon shows green when all required fields are set: SMTP Server Host, SMTP Server Port, Recipient Email, and either (SMTP Username + Password when authentication is required) or (From Address when authentication is not required).

When the configuration is not fully configured, a yellow alert box is displayed informing you that no emails will be sent until the email settings are filled correctly. The Email checkboxes in the Backup Notifications tab will also be greyed out and show "(disabled)" labels.


Available Actions

ButtonDescription
Save the changes made to the NTFY settings.
Sends a test email message using the SMTP configuration. The test email displays SMTP server hostname, port, connection type, authentication status, username (if applicable), recipient email, from address, sender name, and test timestamp.
Delete / Clear the SMTP configuration.

IMPORTANT

You must use the button to make sure your email setup works before relying on it for notifications.

Even if you see a green icon and everything looks configured, emails may not be sent.

duplistatus only checks if your SMTP settings are filled in, not if emails can actually be delivered.


Common SMTP Providers

Gmail:

  • Host: smtp.gmail.com
  • Port: 587 (STARTTLS) or 465 (Direct SSL/TLS)
  • Connection Type: STARTTLS for port 587, Direct SSL/TLS for port 465
  • Username: Your Gmail address
  • Password: Use an App Password (not your regular password). Generate one at https://myaccount.google.com/apppasswords
  • Authentication: Required

Outlook/Hotmail:

  • Host: smtp-mail.outlook.com
  • Port: 587
  • Connection Type: STARTTLS
  • Username: Your Outlook email address
  • Password: Your account password
  • Authentication: Required

Yahoo Mail:

  • Host: smtp.mail.yahoo.com
  • Port: 587
  • Connection Type: STARTTLS
  • Username: Your Yahoo email address
  • Password: Use an App Password
  • Authentication: Required

Security Best Practices

  • Consider using a dedicated email account for notifications
  • Test your configuration using the "Send Test Email" button
  • Settings are encrypted and stored securely in the database
  • Use encrypted connections - STARTTLS and Direct SSL/TLS are recommended for production use
  • Plain SMTP connections (port 25) are available for trusted local networks but are not recommended for production use over untrusted networks