Email Settings

The Email Settings page configures how your QuickBox Pro server sends emails for password resets, registration activation, welcome messages, and administrative notifications. It is organized into four tabs: Provider for selecting and configuring your email service, Templates for customizing email content, Advanced for delivery settings, and Log for reviewing sent emails.

Admin only

Email Settings requires admin privileges (admin.settings.read to view, admin.settings.update to modify). Navigate to Settings > Email from the sidebar.

Required for key features

Email must be configured for password reset, email-based registration activation, and welcome emails to work. Without an email provider, these features are unavailable.

Overview

📮 6 Email Providers

Choose from SMTP, Mailgun, SendGrid, Postmark, SparkPost, or AWS SES — each with provider-specific configuration

✏️ Template Editor

Customize the content of each email type with a live preview and variable substitution

⚙️ Advanced Delivery

Fine-tune TLS settings, from address, and reply-to address for your email configuration

📋 Delivery Log

View sent email history with delivery status for each message

Provider tab

Select and configure your email delivery service. QuickBox Pro supports six providers:

📧

Direct SMTP

SMTP (any server)

🚀

Transactional Email Services

MailgunSendGridPostmarkSparkPostAWS SES

Each provider has its own configuration form with the required fields:

SMTP — Host, port, username, and password for your SMTP server
Mailgun — API key and domain
SendGrid — API key
Postmark — Server token
SparkPost — API key
AWS SES — Access key, secret key, and region

After entering your credentials, use the Test button to send a test email and verify that your configuration is working correctly.

Templates tab

Customize the content of emails sent by the dashboard. Each email type has its own template that you can edit:

Template	When it is sent
Account Activation	When a user registers and email activation mode is enabled
Welcome Email	After a new user's account is fully activated
Password Reset	When a user requests a password reset
Notification Email	When an admin sends an email notification to users

The template editor provides:

Subject line — Customize the email subject
Body content — Edit the HTML and plain-text versions of the email
Variables — Insert dynamic values like the user’s name, server URL, or activation link
Live preview — See how the email will look before saving
Test send — Send a test email using the current template to verify formatting
Reset — Restore a template to its default content

All emails are wrapped in a branded QuickBox Pro layout with a dark theme, logo, and footer.

Advanced tab

Fine-tune email delivery settings:

From address — The email address that appears in the “From” field of sent emails
Reply-to address — The address users see when they click “Reply” on a received email
TLS settings — Configure TLS encryption for SMTP connections

Log tab

The email delivery log shows a history of all emails sent by the dashboard:

View the recipient, subject, timestamp, and delivery status of each email
Check for failed deliveries and review error messages
Use the log to troubleshoot delivery issues and confirm that emails are reaching users

Best practices

Do

Send a test email immediately after configuring your provider to verify the setup before users depend on it
Set a recognizable from address (e.g., noreply@yourdomain.com) so users know the email is legitimate
Review the email log periodically to check for delivery failures — silent failures mean users are not receiving important messages
Customize the welcome email template to include helpful getting-started information for new users
Use a transactional email service (Mailgun, SendGrid, etc.) for better deliverability than a self-hosted SMTP server

Don't

Don't enable email-dependent features (email activation, password reset) without configuring a provider first — users will be unable to complete these flows
Don't use your personal email as the from address — it may trigger spam filters and makes the emails look unprofessional
Don't delete or heavily modify the system templates without testing — broken templates can prevent users from activating accounts or resetting passwords

FAQ

If you already have an SMTP server, use SMTP. For the best deliverability with minimal setup, transactional services like Mailgun, SendGrid, or Postmark are recommended. AWS SES is ideal if you are already using AWS infrastructure. All six providers produce the same results — choose based on what you already have.

Yes, but consumer email providers often have sending limits and may require app-specific passwords or OAuth setup. For a production server, a dedicated transactional email service is more reliable.

Changing the provider only affects future emails. Previously sent emails and their log entries are preserved. The new provider is used immediately for the next email sent by the dashboard.

Configure SPF, DKIM, and DMARC DNS records for your domain. Use a reputable transactional email provider. Set a proper from address that matches your domain. These steps significantly improve deliverability.

Yes. Simply do not configure an email provider. Without a configured provider, no emails are sent. Features that depend on email (password reset, email activation) will be unavailable, but the dashboard continues to function normally for all other operations.

Registration Settings

Email activation mode and welcome email toggle

Notification Settings

Send notifications to users via email and other channels

General Settings

Instance settings and feature flags

Your Profile

Update your email address for account notifications

Join the Community

Media server operators sharing configs, getting support, and shaping the future of QuickBox Pro.

Dedicated Support

Feature Previews

Community Configs

Active Discussions

Join Discord Server