Mail settings
Let your panel send email, and check that it arrives.
License required
Email needs the Email Notifications license feature. Without it the Mail tab is not there.
The Mail settings page configures SMTP for outgoing email. Navigate to Admin > Settings > General, then click the Mail tab.
Enable email
The Enable Email switch controls all outgoing email. This email covers address verification, password resets, and notifications.
If email is off, the panel cannot deliver a verification message. The Require Email Verification toggle on the Features page stays locked until you configure SMTP.
SMTP configuration
| Setting | Description |
|---|---|
| SMTP Host | The hostname of your mail server, for example smtp.example.com. |
| Port | The port for SMTP connections. The default is 587. |
| Username | The SMTP account name. |
| Password | The SMTP account password. An eye button shows or hides the value. |
When a password is already stored, the label reads Password (leave blank to keep).
The panel detects the encryption from the port. Port 587 uses TLS, port 465 uses SSL, and port 25 uses no encryption. The page has no encryption dropdown.
Sender information
| Setting | Description |
|---|---|
| From Email | The address of the sender, for example noreply@example.com. |
| From Name | The display name next to the address, for example BadgerPanel. |
Click Save Settings to store the SMTP and sender values.
Test configuration
Two tests are available. Both need Enable Email to be on.
- Test Connection opens a connection to the SMTP server with the values on screen. Use it to find a wrong host, port, or password.
- Enter an address, then click Send Test. The panel sends a message to that address. Look in the inbox and in the spam folder.
Email template appearance
This card controls the look of every system email. It saves with its own Save Appearance button, separate from the SMTP settings.
| Setting | Description |
|---|---|
| Use Panel Theme Colors | Uses the primary colour and the secondary colour of the panel. |
| Primary Color | The colour of buttons and accents. This field appears only when the theme colours are off. |
| Secondary Color | The colour of the header gradient. This field appears only when the theme colours are off. |
| Logo URL (Optional) | An image for the email header. Leave it empty to show the panel name as text. |
| Custom Footer Text (Optional) | Replaces the default copyright line. |
| Custom HTML Header (Optional) | HTML above the body of every system email. Use inline styles. |
| Custom HTML Footer (Optional) | HTML below the standard footer of every system email. |
A live preview under the fields shows the header, the body, a sample button, and the footer.
Common SMTP providers
| Provider | Host | Port | Notes |
|---|---|---|---|
| Gmail | smtp.gmail.com | 587 | Use an App Password when the Google account has two-factor authentication. |
| Outlook / Microsoft 365 | smtp.office365.com | 587 | Use your full email address as the username. |
| Mailgun | smtp.mailgun.org | 587 | The credentials are in the Mailgun domain settings. |
| SendGrid | smtp.sendgrid.net | 587 | Use apikey as the username and your API key as the password. |
| Amazon SES | email-smtp.[region].amazonaws.com | 587 | SMTP credentials are separate from AWS access keys. |
| Zoho Mail | smtp.zoho.com | 587 | Use your full Zoho email address as the username. |