Mail Server

If you deploy a Mail Server for the first time, Recommend clicking to view:

Mail Server Basics

Mail Server menu

Mail Marketing	Mail Domain	Mailboxes	Email	Other Settings

Mail Marketing

Overview

Mail Marketing --> Overview

Marketing Task

Mail Marketing --> Marketing Task

• Add Send Tasks: Use email content templates to send bulk emails.

• Time : Display the time when the task was added

• Mail Subject : Display the email subject of the email

• Sender : Display the email address from which the email is sent

• To : Display the number of recipients

• Success : Display the number of successfully sent emails

• Fail : Displays the number of emails that failed to be sent. Click to view the detailed information sent.

• Status : Task status: Pending, Done.

• Edit : The task is in Pending status and can be edited.

• Send : The task is in Pending status and can be sent.

• Remark: Display the notes for this task.

• View : The task is in Done status, Can view the details of the task.

• Error logs : The task is in the Done state, and an error message indicating that the email failed to be sent is displayed.

• Delete : delete task

Add Send Tasks

Mail Marketing --> Marketing Task --> Add Send Tasks

• From : Select the email address to send the email to

• Display Name: The name displayed for the sender.

• Subject: The title displayed in the email.

• Recipients: Select the group of email subscribers to send to; Click Create to upload a new subscriber group.

• Email template: Select the email content template to be sent, which needs to be created in Template first.

• Save in Outbox: Whether to save in the Outbox.

• Unsubscribe Link: Add an unsubscribe link. The recipient clicks the unsubscribe link to opt-out from the email, which will be recorded as Unsubscribe.

• Threads num: Automatically set the number of threads based on the number of CPU cores or manually set the number of threads for sending emails.

• Send time: Choose the time to send.

• Remark: Add a note for this task.

• Send Test email to: Enter the recipient's email to send a test email and check the effect.

Template

Mail Marketing --> Template

• Add Template: Add email content template, which can later be used to create tasks for sending emails through Marketing Task.

• Import：Upload templates exported from aaPanel

• Name: The name of the email content template.

• Add Time: The time the email content template was added.

• Create task: Create a Marketing Task using the specified email content template to send emails.

• Duplicate: Duplicate the email content template.

• Export: Export the email content template.

• Preview: View the email content template.

• Edit: Modify the email content template.

• Delete: Remove the email content template. Once deleted, it cannot be restored, please proceed with caution.

Add Template / Edit

Mail Marketing --> Template --> Add Template

Mail Marketing --> Template --> Edit

Create an email content template based on your needs, and use Marketing Task to add a task for sending emails with it.

• Drag :

• Upload HTML :

Subscribers

Mail Marketing --> Subscribers

• Subscription / Unsubscription Trends: Display the trends of email subscribers subscriptions and unsubscriptions.

• Import: Batch import email subscribers, supporting files in TxT and JSON formats with one entry per line.

• Email: Display the email addresses of the subscribers.

• Group Name: Show the group to which the email subscribers belong.

• Add Time: The time the email subscriber was added.

• Change List: Change group of email subscribers.

• Unsubscription / Subscription: Change the subscription status of the email subscribers.

• Delete: Remove email subscribers from the specified group.

Groups

Mail Marketing --> Groups

• Add Group: Add email subscription group, which can later be managed through Subscribers.

• Group Name: The name of the email subscription group.

• Subscription: Display the number of subscriptions in the email subscription group.

• Unsubscription: Display the number of unsubscriptions in the email subscription group.

• Add Time: The time the email subscription group was added.

• Rename: Modify the name of the email subscription group.

• Delete: Remove the email subscription group, including the email subscribers.

Suspend List

Mail Marketing --> Suspend List

Automatically added to the Suspend List for email sending statuses of Deferred or Bounced.

Deferred: Retry sending after a period of time. If it remains undeliverable after multiple attempts, it may change to "Bounced" status.

Bounced: When an email cannot be delivered and is returned to the sender, it is marked as "Bounced". This email has permanently failed to deliver.

• Scan Invalid Domains : Select a subscriber of a group and scan the invalid email address

• Scan Logs : View the logs for automatic scanning of invalid domains

• Auto block failed emails : Automatically add the failed email address to Suspend List after turning on

• Clear: Clear the current list.

• Email: Display the email addresses of the subscribers.

• Mail Subject: Display the subject of the sent email.

• Type: Show the type of email sent: Deferred or Bounced.

• Status: Display the sending status of the email: Invalid, Checking.

• Add Time: The time the email was added to the list.

• Delete: Remove the email subscriber from the Suspend List to resend the email.

Automation

Mail Marketing --> Automation

Execute tasks based on set conditions: For example, when there are new subscribers in Group, automatically send emails to the new subscribers.

• New Automation : Create a new triggered automation task

• Name : Display the name of the automation task

• Status : Display the status of the automation task

• Delivered / Sent : Show the number of emails sent and successfully delivered

• Clicked : Display the number of emails that have been clicked

• Opened : Display the number of emails that have been opened

• Duplicate : Create a copy of the current automation task

• Rename : Modify the name of the automation task

• Edit : Modify the content and conditions of the automation task

• Delete : Delete the automation task

New Automation

Mail Marketing --> Automation --> New Automation

Tip: Ned to have a Group and email Template first. Remember to click Save after selecting

For example: select the group of Specified Group, and if the group has a new subscriber, send an email to the new subscriber

In addition to email, can also choose from: Delay, Webhook

Mail Domain

• Add Domain : Add a new domain name to the Mail Server.

• Refresh domain record : Refresh domain name DNS records. Generally, it takes 2 minutes or more for new records to take effect after they are added.

• Domain name : Display domain name

• Not in Spam List: Check if the domain is on the email Spam list immediately and on a schedule. You can enable the option Notify me when an IP/Domain is blacklisted in Other Settings to receive notifications.

• Quota : Display the maximum usage space capacity of the domain name

• Mailboxes : Display the number of email users of the domain name

• Default mailbox size : Displays the default mail space capacity of the mail user of the domain name

• Catch All : Whether to add catch all of the domain name to receive non-existent email addresses

• SSL : Configure the SSL certificate of the domain name. It is recommended to use the pan-domain name certificate: *.xxx.com

• WebMail : Add a Roundcube website to the PHP project and manage emails through Roundcube.

• DNS Record : Click the DNS record of the domain name and follow the prompts to add it in the domain name resolution.

• Edit : Modify the information of this domain name

• Delete : Delete this domain name, email users, emails, etc. will also be deleted. Please back up data to avoid data loss.

Add Domain

Mail Domain --> Add Domain

• DNS record : Automatic, Manual parsing can be selected, where Automatic will automatically add A, MX, SPF, DKIM and DMARC. Note that Automatic requires adding the corresponding DNS API in Domains and having a valid SSL certificate for the domain to function properly.

• Domain name : Enter the domain name to be added, such as: aapanel.com

• A record : Enter the A record of the domain name. This A record must point to the IP of the server, such as: mail.aapanel.com

• IPs : Enter the IP address of this server

  1. The IP must be consistent with the A record of the domain name
  2. The IP is consistent in the Settings of aaPanel. If it is incorrect, please modify Server IP manually in the Settings.

• Domain quota : Enter the space capacity limit of the domain name

• Mailboxes : Enter the maximum number of email users to add. New email users cannot be added after exceeding the limit.

• Catch All : Enter the email address to receive catch all. When the recipient sends a message to a non-existent email address, it will be sent to the catch all email address.

DNS Record

Mail Domain --> DNS Record

• Please follow the prompts to add MX records and TXT records at the domain name provider or domain name management office.

• PTR records are generally configured on the server provider's website, or at the server network provider.

For more configuration, please refer to Example

Mailboxes

• Add Mailbox : Add a new mail user

• Batch Create : Batch create mail users

• Import : Import mail users

• Export : Export mail users

• Username : Display the email address of the mail user

• Password : Display, copy the password of the mail user

• Login info : Copy the email user’s information, password and other information

• Quota : Display the mail space capacity of the mail user

• Type : Display the type of mail user: General user, Admin.

• Status : Display the status of the mail user, disabled or enabled

• WebMail : Log in without password or enter account information to log in to WebMail

• Edit : Modify the information of this email user

• Delete : If you delete this mailbox user, emails, etc. will be deleted. Please back up data first to avoid data loss.

Add Mailbox

Mailboxes --> Add Mailbox

• Name : Enter user name

• Quota : Enter the mail space capacity of the mail user

• User type : Select the type of mail user: General user, Admin.

• Email Address : Enter the prefix of the email address

• Email Password : Enter the password of the mail user

• Status : User status, disabled or enabled

How to use Mail Client

Click to view How to use Mail Client

Email

Inbox

Email --> Inbox

• View, Spam, Delete Emails received by the specified user

Outbox

Email --> Outbox

• View, Delete emails that the specified user has sent.

Spam

Email --> Spam

• View, Unmark, Delete Mark emails received by a given user as spam

Send mail

Email --> Send mail

• Send email using specified user

Tips: This feature is only recommended for testing the sending function. It is recommended that you use an SMTP client to send emails.

Other Settings

Common settings

Other Settings --> Common settings

• WebMail : Add a Roundcube website to the PHP project and manage emails through Roundcube.

• Mail save time : Set the storage time of all emails. After this time, the emails will be permanently deleted.

• Notify me when an lP/Domain is blacklisted :

• Notify me when mail service is down :

• Automatically start services : Monitor mail serverpostfix,dovecot,rspamdWhether it is running, if not, it will start automatically.

• Service Status : Manage mail serverpostfix,dovecot,rspamdService status and configuration.

BCC

Other Settings --> BCC

BCC is a "Blind Carbon Copy" that allows sending a copy of an email to specified recipients, but hiding those recipients' email addresses from being visible to other recipients.

• Add BCC

1. Need Copy : Enter the email address of the person being BCCed

2. Copy to : Enter the receiving email address

3. BCC Type : Select BCC type, supported when sending and receiving emails.

4. Active : Enable BCC

Mail forward

Other Settings --> Mail forward

• Add Forward

  1. Status : Enable forwarding

  2. Forwarded users : Enter the email address of the user to be forwarded

  3. Domain : Enter the forwarded domain name

  4. Receiving user : Enter the email address of the user you want to receive

Auto Responder

Other Settings --> Auto Responder

Specify the recipient to automatically reply to the specified content after receiving the email

Backup

Other Settings --> Backup

• Backup Plan : Set up an email backup plan and back up the email directory /www/vmail.

• Mail import : Import backup to server. Can be obtained from Upload from local,Select in server, import from the backup list

Example -- Add domain to Mail Server

For example: The domain name is kern123.top, the A record is 173.kern123.top, and the server IP is 192.168.66.173.

This is a sample domain name; please replace it with your own domain name, A record, and server IP.

1. Add the A record 173.kern123.top in the domain management section, pointing to the server IP 192.168.66.173. AS follows:

   

2. Add the email domain in aaPanel Mail Server. As follows:

   Mail Server --> Mail Domain --> Add Domain

   

   • If you receive the message A record parsing failed:

     1. Please check if the A record is correct.

     2. Please check if the Server IP that the A record points to is correct.

     3. Please check if the IP address displayed in the top left corner of aaPanel is correct. If it is not correct, please go to Setting and modify the Server IP to your server IP.

3. After successfully adding the domain to the mail server, click on DNS Record.

   Follow the prompts to add MX, SPF, DKIM, DMARC, and other records in the domain management section, as follows:

   

   • MX Record:

   • SPF Record:

   • DKIM Record:

   • DMARC Record:

   • PTR Record: Generally set up at the network provider or server provider.

     The displayed name may be: Reverse DNS, PTR Records, or rDNS. Refer to Vultr:

   Domain resolution records have been successfully added:

   Tips: After adding the domain resolution records, it may take 1-20 minutes or longer to take effect.

   The resolution records will take effect, as follows:

   You can also use this website to check if the corresponding records are effective:

4. Deploy the SSL certificate to the domain of the Mail server

   You can refer to the tutorial in this guide for deploying the SSL certificate.

   Click to view How to apply for a pan-domain name certificate

5. After adding the domain, you need to add email users to use the email functionality properly.

   Mail Server --> Mailboxes --> Add Mailboxe

   

6. Send a test email to verify that the functionality is working correctly.

   • Send a test email to yourself or another email address:

   Mail Server --> Email --> Send mail

   

   • Check your email inbox:

   

Feedback or Suggestions

If you encounter problems or suggestions during use, please contact us through the following methods:

• (Please describe in detail or provide screenshots)

1. Email: [email protected]

2. Forum: https://www.aapanel.com/forum

3. Discord: https://discord.gg/Tya5yceBpd

4. Telegram: https://aapanel.com/tg

5. GitHub: https://github.com/aapanel/aapanel

   If you like aaPanel, please give it a Star