Note: This article is a work in process, will keep adding more information.

If you have recently upgraded CyberPanel and your email stopped working then follow this guide to debug and possibly fix your email system.

We recommend to upgrade your CyberPanel via CyberPanel cloud to avoid any such issue in the future:

How to upgrade your CyberPanel using CyberPanel Cloud

Step 1: Check and Fix Postfix Service

First thing to do is to check weather postfix services is running:

systemctl status postfix

Run the command above to check if postfix is running, if it is, then you should see something like:

● postfix.service - Postfix Mail Transport Agent
   Loaded: loaded (/usr/lib/systemd/system/postfix.service; enabled; vendor preset: disabled)
   Active: active (running) since Thu 2021-04-15 02:00:43 CEST; 1 day 18h ago
 Main PID: 3745676 (master)
   CGroup: /system.slice/postfix.service

If postfix is running and you can't send emails then read our troubleshooting guide to find out why.

If postfix is not running then you can try starting it, but if you can't then check weather it is installed or not

Centos 7 or Centos 8

[[email protected] ~]# yum list installed | grep postfix
postfix3.x86_64                2:3.5.8-1.gf.el7      @gf-plus                   
postfix3-ldap.x86_64           2:3.5.8-1.gf.el7      @gf-plus                   
postfix3-mysql.x86_64          2:3.5.8-1.gf.el7      @gf-plus                   
postfix3-pcre.x86_64           2:3.5.8-1.gf.el7      @gf-plus                   
[[email protected] ~]#

Ubuntu 18 or Ubuntu 20

apt list --installed | grep postfix

If you don't see any postfix packages installed, then postfix is not installed in your system. You can install them, first enable gf repo (for Centos 7 or Centos 8) on your system.

Note: Take backup of your postfix configurations at /etc/postfix and restore them after installation

Centos 7

yum --nogpg install https://mirror.ghettoforge.org/distributions/gf/gf-release-latest.gf.el7.noarch.rpm

Centos 8

dnf --nogpg install https://mirror.ghettoforge.org/distributions/gf/gf-release-latest.gf.el8.noarch.rpm

now install postfix

Centos 7

yum install --enablerepo=gf-plus -y postfix3 postfix3-ldap postfix3-mysql postfix3-pcre

Centos 8

dnf install --enablerepo=gf-plus postfix3 postfix3-mysql -y

Ubuntu 18 or Ubuntu 20

apt-get -y install postfix postfix-mysql

Once postfix is installed again, you can restore the backup of configurations file and restart postfix and verify that it is working.

Step 2: Check and Fix Dovecot Service

Second thing to do is to check weather dovecot services is running:

systemctl status dovecot

Run the command above to check if dovecot is running, if it is, then you should see something like:

● dovecot.service - Dovecot IMAP/POP3 email server
Loaded: loaded (/usr/lib/systemd/system/dovecot.service; enabled; vendor preset: disabled)
Active: active (running) since Thu 2021-04-15 02:00:44 CEST; 1 day 18h ago
Docs: man:dovecot(1)
Main PID: 3745695 (dovecot)

If dovecot is not running then you can try starting it, but if you can't then check weather it is installed or not

Centos 7 or Centos 8

[[email protected] ~]# yum list installed | grep dovecot
dovecot23.x86_64 1: @gf-plus 
dovecot23-mysql.x86_64 1: @gf-plus 
[[email protected] ~]#

Ubuntu 18 or Ubuntu 20

apt list --installed | grep dovecot

If you don't see any dovecot packages installed, then dovecot is not installed in your system. You can install them, first enable gf repo (for Centos 7 or Centos 8) on your system.

Note: Take backup of your dovecot configurations at /etc/dovecot and restore them after installation

Centos 7

yum --nogpg install https://mirror.ghettoforge.org/distributions/gf/gf-release-latest.gf.el7.noarch.rpm

Centos 8

dnf --nogpg install https://mirror.ghettoforge.org/distributions/gf/gf-release-latest.gf.el8.noarch.rpm

now install dovecot

Centos 7

yum --enablerepo=gf-plus -y install dovecot23 dovecot23-mysql

Centos 8

dnf install --enablerepo=gf-plus dovecot23 dovecot23-mysql -y

Ubuntu 18 or Ubuntu 20

apt-get -y install dovecot-mysql dovecot-imapd dovecot-pop3d

Once dovecot is installed again, you can restore the backup of configurations file and restart dovecot and verify that it is working.

Almost 2 years ago we launched CyberPanel Platform (which is now discontinued) it allowed you to connect and manage your CyberPanel servers centrally. Upon user requests we've refactored the platform and launched CyberPanel Cloud.

We've removed all the redundant features that were in the old platform and added new and improved features to CyberPanel Cloud

On this platform, we are going to give a bunch of features to our users which include support and fixes. Here are some key features for our users:

  1. Proprietary High Availability
  2. Improved WordPress Manager
  3. One-click Email fix
  4. One-click DNS fix
  5. One-click FTP fix
  6. MySQL Optimizer.
  7. Server Status
  8. Priority Support

High Availability/ Clustering:

High Availability/Clustering has been one of the most requested features within CyberPanel Cloud.

The High Availability feature allows you to maintain 100% uptime for your sites. In this feature, CyberPanel Cloud will take care of creating 100% replica of your Main server to a secondary Fail over server. We will go one-step further and take care of DNS switch in case your Main server goes down so that you can sleep peacefully.

Read more about this feature here.

WordPress Manager:

We have introduced new and improved WordPress manager on CyberPanel Cloud. Features of WordPress Manager are listed below:

  1. Transfer Site (You can easily transfer your site using CyberPanel Cloud WP manager to any other server).
  2. Create as many staging sites with click of a button and deploy them to production.
  3. Active LSCache with a single click.
  4. Update and manage Themes and Plugins (One-click updates)
  5. Enable debug, enable maintenance mode and a lot more features.

One-click email fix:

Here on this Cloud Platform, we provide some exclusive features to our users. A lot of users face issues with their mail server which can take hours to diagnose and resolve. We received a lot of requests and complaints about email issues.

On this new cloud platform, we have launched a 1-Click solution for our users, you just need to click a button, and each and every mail related issue will be resolved for you.

One-click DNS fix:

Just like the One-Click Email solution we have also have a One-Click DNS fix. If you are facing any issue with your DNS you can signup on to our cloud and get priority support to solve it.

This is also an exclusive feature and only access by the users who signup on this cloud platform.

One-click FTP fix:

We notice that there are also some users who face issues with their FTP. We also have a One-Click solution for FTP.

Right now there is a 25% discount on all plans. 6 months and 12-month plans have 1 month free on top of a 1 advanced payment.



In version v2.0.0, CyberPanel has introduced email queue management. This feature makes it easy for you to check the mails in queue, their status and provides you with the options to flush them again or delete individually or collectively.

The feature is already installed and enabled and can be accessed at https://<SERVER>:8090/emailPremium/mailQueue  or from Mail Settings -> Email Queue

It will show a new screen with a list of messages and available options

If you aren't seeing any messages, either you don't have any emails in the queue or you can run the following command so that any outgoing email is automatically queued:

postconf -e defer_transports=smtp; sudo postfix reload

The list shows all the mails in the queue, you can view any of them by clicking "View Message

The options above the list perform the following

In version 2.0.0, CyberPanel has added the option to get all server logs by email. This can be very beneficial for a timely update if your server has some error or if it's behaving abnormally. This also includes notifications of

In order to enable the service, login to CyberPanel

Make sure you have the correct email address in your admin account. You can verify it by clicking the username and then "View Profile"

If the email isn't correct, use the "Edit Profile" option to change it.

Go to Server Mail under Logs menu

It will take you to a new screen

The configuration is pretty simple, if you don't want to send via third-party like SendGrid or MailGun etc, all you have to do is to choose default and click save

However, if you want to use third-party, choose SMTP

In order to fill SMTP credentials, go to your mail provider's dashboard and get the information

Here are a few examples


Use the following

SMTP Host: smtp.mailgun.com

Port : 587

Username and password as you have set up according to the video.

Amazon SES

Save the settings and you will receive email update about your server

After creating an email account in CyberPanel some users would like to configure their email accounts to third party email clients such as Outlook or Thunderbird.

Both these clients have auto-discover functionality, this functionality will try to automatically configure your email settings so that end-user won't have to do anything. For example, if on Thunderbird I configure:

Thunderbird may suggest the following settings:

Server hostname: mail.cyberpanel.net

IMAP Port: 143

Now Thunderbird will be looking for a valid SSL for mail.cyberpanel.net and if valid SSL is not offered by the server you will get a self-signed SSL error.

How to resolve Self-signed SSL Error

After version v1.9.4 of CyberPanel, upon website creation, CyberPanel will create mail.domain.com as a child domain to while creating a website and also issue SSL for it. Then CyberPanel will add edit /etc/dovecot/dovecot.conf and add the following to the file:

local_name mail.domain.com {
  ssl_cert = </etc/letsencrypt/livemail.domain.com/fullchain.pem
  ssl_key = </etc/letsencrypt/live/mail.domain.com/privkey.pem

and then restart dovecot service using systemctl restart dovecot. This way there will be no SSL errors on either Outlook or Thunderbird.

Manually setting this up

Let say you are on some of the old versions of CyberPanel or you have already created a website before upgrading to v1.9.4. You can go ahead and create mail.domain.com as a child-domain to your master domain also make sure to issue SSL for this domain.

Step 1: Open the file /etc/postfix/main.cf using any editor

sudo nano /etc/postfix/main.cf

Step 2: Comment the first two lines in that file by adding an # sign at the beginning.

# smtpd_tls_cert_file = /etc/pki/dovecot/certs/dovecot.pem 
# smtpd_tls_key_file = /etc/pki/dovecot/private/dovecot.pem

Step 3:  Add the following lines after changing. Remember to replace YourPrimaryMailServerDomain with the your own domain.

# provide the primary certificate for the server, to be used for outgoing connections 
smtpd_tls_chain_files = 

Step 4: In order to support SNI you need to add the following lines at the end

# provide the map to be used when SNI support is enabled 
tls_server_sni_maps = hash:/etc/postfix/vmail_ssl.map

After all the above steps your files should look like this

# smtpd_tls_cert_file = /etc/pki/dovecot/certs/dovecot.pem
# smtpd_tls_key_file = /etc/pki/dovecot/private/dovecot.pem

# provide the primary certificate for the server, to be used for outgoing connections
smtpd_tls_chain_files =

# provide the map to be used when SNI support is enabled
tls_server_sni_maps = hash:/etc/postfix/vmail_ssl.map

Step 5: Create a new file in /etc/postfix with the name of vmail_ssl.map

sudo touch /etc/postfix/vmail_ssl.map

Step 6: Edit the file to add your domain's SSL certificates to the list like this

mail.yourprimarymailserverdomain.com /etc/letsencrypt/live/mail.yourprimarymailserverdomain.com/privkey.pem /etc/letsencrypt/live/mail.yourprimarymailserverdomain.com/fullchain.pem

Step 7 (Optional): If you have more than one domain to be supported add all of them one per line. The resulting file should look like this

# Compile with postmap -F hash:/etc/postfix/vmail_ssl.map when updating
# One host per line
mail.yourprimarymailserverdomain.com /etc/letsencrypt/live/mail.yourprimarymailserverdomain.com/privkey.pem /etc/letsencrypt/live/mail.yourprimarymailserverdomain.com/fullchain.pem
mail.yoursecondarymailserverdomain.com /etc/letsencrypt/live/mail.yoursecondarymailserverdomain.com/privkey.pem /etc/letsencrypt/live/mail.yoursecondarymailserverdomain.com/fullchain.pem
# add more domains with keys and certs as needed

Step 8: Open /etc/dovecot/dovecot.conf

sudo nano /etc/dovecot/dovecot.conf

Step 9: Append the following to the end of the file, replace domain.com with your own domain

local_name mail.domain.com {
  ssl_cert = </etc/letsencrypt/live/mail.domain.com/fullchain.pem
  ssl_key = </etc/letsencrypt/live/mail.domain.com/privkey.pem

Step 10: Re-compile postmap with SNI using the following command

postmap -F hash:/etc/postfix/vmail_ssl.map

Step 11: Restart Postfix.

systemctl restart postfix

Step 12: Restart Dovecot

systemctl restart dovecot

Connect again using a mail client and you should not see the error.

CyberPanel and cPanel are both hosting control panels, and they help you manage your websites. With one command you get a fully functional LAMP stack that is ready to serve your web applications. Let see how CyberPanel is a feasible cPanel alternative.

If you are new to development or managing sites then you will sooner or later discover that some variation of the LAMP stack  (Linux, Apache, MySQL, and PHP) is mandatory to run your sites. Here Apache can be replaced with other web servers such as OpenLiteSpeed, and PHP can be replaced with other programming languages like Python. Control panels like cPanel and CyberPanel offer many other features on top of the LAMP stack, and these features can help you in many ways.

Basic Feature Comparison

cPanel is almost 20 years old, and 20 years ago everything was very different. Hardware and bandwidth were expensive, so cPanel was designed to be used by shared hosting companies. Usually, in a shared hosting environment, a single server is hosting hundreds or even thousands of sites, which allows the company to get maximum profit out of existing hardware. Everything was expensive back then.

Considering these facts, cPanel is bloated with umpteen number of features, many of which are not required by a normal end-user. Additionally, all of these features make cPanel expensive to buy and a high consumer of server resources.

Fast-forward 20 years, and these days hardware and bandwidth are not as expensive as they were in the past. Anyone can get a virtual private server for $5/month, with roughly 1GB of RAM and 20GB disk space. If configured right, a $5 VPS can host 10-20 sites easily or even 100 static sites. The most basic cPanel package is $15. Spending $5 + $15 does not make sense if you only want to host a simple WordPress site.

CyberPanel to the rescue! CyberPanel is a great cPanel alternative. It offers all of the features needed to host and run a site including Web, DNS, FTP, and Email server. On top of that CyberPanel also offers two variants: Free and Paid.

CyberPanel Free vs Paid Variant

CyberPanel's free version is 100% identical to CyberPanel Enterprise, the paid version. However, the free version comes with the OpenLiteSpeed web server, whereas the paid version comes with LiteSpeed Enterprise and our premium support.

You can learn the difference between OpenLiteSpeed and LiteSpeed Enterprise Web Server here. The most relevant differences are:

Note: On our pricing page, the listed plans include the cost of the corresponding LiteSpeed Web Server license. This means you do not need to buy a web server license separately. You get huge saving plus high performance. To see all of the plans in detail, you can visit the store. Or if you want to try the fully function free version of CyberPanel, just run this command on your terminal:

sh <(curl https://cyberpanel.net/install.sh || wget -O - https://cyberpanel.net/install.sh)

Within a few minutes, your server is ready to deploy super fast WordPress or other web apps. If you are still not convinced then learn why people are moving their WordPress setups to CyberPanel.

Use Case: cPanel vs CyberPanel

Let's walk through a website administrator's daily routine tasks. Since WordPress is the most-used CMS, we will use that as an example. We'll create a site, install WordPress, set up SSL, back up the site, use the staging features on CyberPanel, and finally set up email.

Step 1: Buy Server and Install Control Panel

Some hosting companies will give you pre-installed servers, if you chose a specific control panel. On the other hand, you can also self-install cPanel or CyberPanel.

To install cPanel you can run the following command on your server terminal:

cd /home && curl -o latest -L https://securedownloads.cpanel.net/latest && sh latest

After command line installation is complete, visit https://<IP Address>:2087. During this first visit, you will need to set up your basic configuration. This can be hard for new or inexperienced users.

Installing CyberPanel is comparatively easy, as you don't need to do any configuration once the installation is completed. To install, run the following command:

sh <(curl https://cyberpanel.net/install.sh || wget -O - https://cyberpanel.net/install.sh)

After successful installation, you can immediately visit the CyberPanel interface at https://<IP Address>:8090, with no additional configuration required.

Step 2: Create a Website

cPanel via WHM

cpanel alternative


To create a website via cPanel + WHM, you would follow these steps:

  1. Log into WHM with your username and password, or enter your URL (example.com/WHM or example.com:2087)
  2. Go to Create a New Account by searching on left top search bar
  3. Enter your site's Domain
  4. Enter your Username
  5. Enter your Password
  6. Provide an Email Address
  7. Choose a package. The default option is for unlimited resources, or you can enter resources (disk space, bandwidth, ftp accounts etc.) manually according to your requirements.
  8. Select a default language for your website.
  9. Update Mail Routing Service, in which you can choose to automatically detect the configuration
  10. Press the Click to Create button, and within 3-to-5 seconds, your account will be created in WHM. Then, you will see a dialog box to enter cPanel via a list of websites.

This process is not user-friendly. Beginners don't need many of the features, nor do they necessarily know how to determine their requirements based on projected usage. Beginners need more time to understand the complexity of the software.


Creating a website on CyberPanel is much easier than with cPanel. CyberPanel is designed for end-users to create their website and manage it. CyberPanel's GUI (Graphical User Interface) is simple and user-friendly as compared to cPanel.


Follow the steps below to create a website on CyberPanel:

  1. Log into CyberPanel with your username and password
  2. Go to Websites > Create Website from left menu bar
  3. Select Package (Choose the default or create your own package according to your requirements.)
  4. Select Owner (Normally admin is used, or you can give management access to any of your users.)
  5. Enter Domain Name (example.com)
  6. Enter Email Address
  7. Select PHP (Options available range from PHP 5.6 to 7.3)
  8. Additional features like SSL, DKIM, and DNS Verification are available with one click, and they are absolutely free.
  9. Click the Create Website button and within 10 seconds, you will have your new website.

Note: If you want SSL to be successfully issued make sure that your site's DNS is already pointed to the server IP.

Step 3: Manage Your Site

The cPanel interface is very complex, compared to CyberPanel. While cPanel has existed for more than 20 years, CyberPanel is designed for end-users and includes all basic and advanced features with a user-friendly GUI. It can be difficult for an end-user to understand WHM and locate the required features (as they are innumerable) but CyberPanel displays all icons in the main dashboard.



Interface of cpanel alternative managing domains


The above image shows the cPanel domain management interface. The dashboard offers major and advanced features in the following categories: Files, Databases, Domains, Email, Metrics, Security, Software, Advanced, Preferences and Applications. These categories narrow down major tasks that are performed by either the system administrator or the end-user. Most of the features, though, are not relevant to the end-user.


Interface of a domain in cyberpanel


The above image shows the CyberPanel interface, which helps end-users to manage their websites in a friendly way. To manage your site, navigate to Websites > List Websites > Manage. If you scroll down, you will find relevant features that are easily understandable for end-users. You can view access logs, control child domains, edit configuration files, visit the file manager, use email marketing, or install applications with our one-click application installer for WordPress, Joomla and PrestaShop.

Step 4: Set up a WordPress Site


setting wordpress on cpanel


When you log into the cPanel dashboard, you will need to go to Domains > Site Publisher where you will follow three steps to set up your website on WordPress: Select your domain, choose a template, and publish your website. The cPanel dashboard carries all of these features under one umbrella, which can be confusing to end-users who just want the basic tools to run their websites.


setting wordpress on cyberpanel


The installation of  WordPress on CyberPanel is very easy as compared to cPanel. Navigate to Websites > List Websites > Manage, where you will find our auto-installer for WordPress with LS Cache Plugin. The LS Cache Plugin feature reduces website load time when compared to other cache plugins because it is built right into the server. It uses disk space to save and serve cache copies. Click WordPress, and it will take you to the above window where you will enter your desired information. The website will be ready to use in 10 seconds.

Step 5: Back up the System

The Backup feature helps to secure/restore your data. In an era of cyberattacks, hackers find loopholes to attack recognized websites. Backup allows you to save your data as per your requirements on a daily and weekly basis. In the case of computer viruses, system files get affected easily and need to be removed from system, otherwise, chances of cyberattacks get increased. It's smart to have a backup of important files.



backup wizard at cpanel

cPanel's backup system offers two types of backup: Full and Partial. A full backup creates an archive of all the files and the configuration of a website. Partial backup allows you to download archive files of the home directory, MySQL databases and email forwarders and filters separately. cPanel is useful for a system administrator to manage their content as an advanced tool, but it is very complex for end-users to understand the backup process. On the other hand, CyberPanel provides a user-friendly backup system with self-explanatory GUI.



Create backup of your website


CyberPanel allows you to restore your data in one click. There are two types of backups that CyberPanel provides to their end-users. After logging into your CyberPanel account, navigate to Backup > Create Backup and it will generate a backup of your website in one go.

Backup file location: /home/<domain name>/backup

Restore backup of your website


To restore your website's data, navigate to Backup > Restore Backup where you can select your website's backup file. Your website will be restored in one click.

incremental backup of your website


Recently, CyberPanel introduced an incremental backup system, which allows you to create a backup of your website's data, databases and emails separately. The purpose of the incremental backup is to reduce repetition of backed up content. It gives you free space at the server level to increase efficiency and reduced bandwidth cost, in case incremental backups are stored remotely.

setup incremental backup destinations


Incremental backup destinations include: Local (default destination), SFTP  (Server IP Address required) and S3 (AWS S3 key required).

Step 6: Stage Your WordPress Site

Digital businesses use staging to test their websites outside of the production environment whenever they need to make changes to their websites. Website changes involve risk. A staging feature helps developers to make changes in a secure environment where your live website will not be impacted. After careful testing, the QA team allows the changes to go live to the website.


This feature is not available in cPanel.


CyberPanel's WordPress Staging Feature allows you to test your websites in a secure environment and then pushes it live when you are fully satisfied with the changes. The staging feature reduces the chances of insecurity, loss of data, bugs, and general failures by keeping the testing phase-out of production. This feature has increased the overall efficiency of end-users' websites.

wordpress staging option in cyberpanel


The first step in staging is to clone the website. Navigate to Main Dashboard > Websites > List Websites > Manage >Clone/Staging.

domain name for staging

When you click on the Clone/Staging dialog box, enter your domain name, and the clone will be created as child domain, pending DNS validation. Once complete, you can start testing.

sync to master in staging


sync website from child domain to master


syncing final step to master


Second, when testing is complete, you can copy the child domain's content back to the master domain. Navigate to Main Dashboard > Websites > List Websites > Manage > List Domain > Manage/Launch > Copy/Sync to Master.

You have the option of syncing your website by copying complete data, database, or changed files.

Step 7: Manage Email


cPanel email system


The cPanel Email system offers advanced features to handle hosting accounts. To create an email account in cPanel you need to log into cPanel > Main Dashboard > Email Accounts.



Creating an email address in cyberpanel

CyberPanel's Email system offers some basic features that are very useful for end-users to communicate officially. To create your email account, navigate to Dashboard > Email > Create Email.


access webmail portal in cyberpanel


After the creation of an email account, you can access the Webmail Portal to send or receive messages. Apart from that, CyberPanel also helps in setting up DKIM, and SPF records along with SSL for email. You can get more deep information in our previous article:

Achieve 10/10 Email score with CyberPanel!


As you can see, anything that you can do with cPanel can be easily achieved in CyberPanel as well. Plus CyberPanel involves little-to-no cost. That is why CyberPanel is a good candidate for the cPanel alternative. From website creation to WordPress installation, everything is super easy and with Incremental Backup, you can sleep in peace.


Install SpamAssassin at:

https://<IP Address>:8090/emailPremium/SpamAssassin

Once installed, you can configure SpamAssassin settings, more details on our blog post.

On a default installation of CyberPanel, Postfix and Dovecot use self-signed SSL. You can now use Let's Encrypt with your mail server. Navigate to:

https://<IP Address>:8090/manageSSL/sslForMailServer

You will see a list of websites/domain here (which you have created via CyberPanel already). Make sure to choose the domain which has RDNS record against your IP Address. Once SSL is successfully issued, Postfix and Dovecot will start using Let's Encrypt SSL.