FlashPanel

Mail ​

Requirements ​

  • The Mail Server feature is available on paid plans only.
  • You need a domain and access to edit its DNS records.

Setup ​

Step 1: Install the Mail Server app ​

  1. Go to your server management page and select Mail Server in the menu. If it is not installed yet, you will find it in the Explore group.
  2. Click Install and wait for the installation to finish.

Once installed, the Mail Server page has three tabs: Account, Domain and Settings.

Step 2: Add an email domain ​

  1. Open the Domain tab and click Add New Domain.
  2. Enter the Domain of your email addresses (e.g., domain.tld).
  3. Enter the Subdomain for the mail server (mail by default, which gives mail.domain.tld).
  4. Tick Make this domain the default domain if you want to use it as the default domain. The first domain you add automatically becomes the default domain.
  5. Click Submit.

TIP

If the domain is connected to DNS Management in FlashPanel, the MX, SPF, DMARC and DKIM records are created automatically.

Step 3: Configure DNS ​

  1. Click the domain row (or the Complete Setup button) to open its setup panel.
  2. The Required DNS Records table lists the records to create (Type, Host, Value, Priority) and the status of each one. Click a value to copy it, then create the matching records at your DNS provider.
  3. Click Check now to check again. Records that are correct are marked as valid.

PTR record

To keep your emails out of spam folders, your server's IP address should have a PTR record (reverse DNS) pointing to your mail server domain (e.g., mail.domain.tld). You cannot create this record yourself; ask your server provider to set it up.

Step 4: Install SSL for the mail server ​

The SSL Configuration section is only shown for the default domain:

  1. Subdomain Site: If there is no website for the mail server domain yet, click Add New to create it.
  2. Subdomain Site SSL Status: If SSL is missing, click Install to open the website's SSL page and install a certificate.
  3. Mail Server SSL Status: Once the website has a valid SSL certificate, click Install to apply it to the mail server.

When every step is done, the domain's Status column changes to Completed.

Managing domains ​

  • Click Set Default to change the default domain.
  • Click the delete button to delete a domain.
  • Click Refresh to reload the list.

Account Manager ​

Open the Account tab to manage email accounts:

  1. Click Add Email Account to create a new account.
  2. Enter the Email and Password (click the key icon to generate a random password).
  3. Optional settings:
    • Catch-All Email: All emails sent to non-existent addresses in the domain are forwarded to this account.
    • Aliases: Other addresses that deliver to this account, separated by commas, tabs or Enter.
    • Email Storage Limit: Maximum mailbox size (e.g., 100M, 1G). Leave empty for unlimited.
  4. Click Add Email Account to save.

In the account list you can:

  • Click Edit to change the password, aliases or storage limit.
  • Click Auto Login to open Roundcube Webmail without entering the password (requires Roundcube to be installed first).
  • Click the info icon to view the Mail Client Setting (server, port and encryption for IMAP, SMTP and POP3).
  • Click an account's delete button to delete it, or the delete button on an alias to remove that alias.

Mail Server Settings ​

The Settings tab lets you:

  • Enable POP3: Allow email clients to receive mail over POP3.
  • Enable Email Filter: Allow creating mail filters.
  • Enable Fail2Ban: Automatically block IPs with too many failed logins.
  • Message Size Limit: Maximum size of a single email (MB). Set 0 for unlimited (not recommended).

Click Save to apply.

Connecting an Email Client ​

Webmail (Roundcube) ​

You can access your email through a web browser using Roundcube Webmail:

  1. Install Roundcube

    • Open the website of your mail server domain (e.g., mail.domain.tld) or create a new website
    • In the website menu, select Install Source Code, then choose Roundcube
    • Follow the installation steps displayed. See Roundcube for details
    • Once installed, a Webmail button appears at the top of the Mail Server page to open this website quickly

  2. Access Webmail

    • Open your web browser and visit https://mail.domain.tld
    • Log in with your email address and password

  3. Using Roundcube

    • Intuitive, user-friendly interface
    • Send/receive emails, manage contacts, calendar
    • Support for file attachments
    • Compatible with any device with a web browser

INFO

After setup is complete, you can use an email client (e.g., macOS Mail, Mozilla Thunderbird, Microsoft Outlook) to manage your emails.

General Settings ​

  • Incoming Mail Server: Use IMAP (recommended).
  • IMAP Server: mail.domain.tld
  • IMAP Port: 993 (SSL/TLS enabled)
  • Outgoing SMTP Server: mail.domain.tld
  • SMTP Port: 465 (SSL/TLS enabled)
  • POP3 Port: 995 (SSL/TLS enabled), if POP3 is enabled
  • Authentication: Use the account's email address and password.

macOS Mail ​

  1. Open Mail and go to Mail > Add Account.
  2. Select Other Mail Account and click Continue.
  3. Enter your email address and password, then click Sign In.
  4. Set up the Incoming Mail Server:
    • IMAP Server: mail.domain.tld
    • Username: Your full email address
    • Password: Your email password
  5. Set up the Outgoing Mail Server:
    • SMTP Server: mail.domain.tld
    • Username: Your full email address
    • Password: Your email password
  6. Click Sign In, then save the settings.

Mozilla Thunderbird ​

  1. Open Thunderbird and go to Account Settings.
  2. Click Add Mail Account.
  3. Enter your name, email address, and password, then click Continue.
  4. Thunderbird will try to auto-detect settings; if it cannot, enter them manually:
    • Incoming Server (IMAP): mail.domain.tld, Port 993, SSL/TLS
    • Outgoing Server (SMTP): mail.domain.tld, Port 465, SSL/TLS
    • Authentication: Normal password
  5. Click Done to complete setup.

Microsoft Outlook ​

  1. Open Outlook and go to File > Add Account.
  2. Select Manual setup or additional server types, then click Next.
  3. Choose IMAP and enter:
    • Incoming Mail Server: mail.domain.tld
    • Outgoing Mail Server: mail.domain.tld
  4. Click More Settings > Outgoing Server tab:
    • Check My outgoing server (SMTP) requires authentication.
  5. Go to the Advanced tab:
    • IMAP Port: 993, Use SSL
    • SMTP Port: 465 (SSL)
  6. Click OK, then Next, and Finish.

Your mail server is now fully configured and ready to use!