For cPanel & WHM 56

This page was last updated on:

Upgrade blockers

New features

Team: Cobra

Purchase and configure SSL certificates

In cPanel & WHM version 56, you can now purchase and automatically install SSL certificates. System administrators can use WHM's Market Provider Manager interface (Home >> Market >> Market Provider Manager) to select the available certificate providers, one of which is the cPanel Store.

We added this functionality to simplify the purchase and installation of SSL certificates. Because search engines often rank secured sites higher than non-secured sites, this feature allows site owners obtain higher rankings in search engines.

This feature is a technology preview.

We use the term "virtual host" in WHM interfaces and documentation, and the term "website" in cPanel.

Free cPanel-signed hostname certificate

As part of the introduction of this feature, cPanel offers valid cPanel & WHM license holders a free cPanel-signed hostname certificate for your server's services. This replaces the certificates for these services that meet any of the following conditions:

Comodo™ cross-signs these cPanel-signed certificates for additional security.

Your server will automatically order the free signed certificate when the server runs the /usr/local/cpanel/bin/checkallsslcerts tool as part of the upcp maintenance script and connects to the license server. The server will download and install the certificate when it is available.

When that signed certificate is less than seven days from expiration, your server will automatically order a replacement free signed certificate. The server will download and install the certificate when it is available. Otherwise, if the signed certificate expires, the server will install a self-signed certificate, and then replace that certificate with the free signed certificate when it is ready.

If you wish to replace your services certificate with one from another provider, use WHM's Manage Service SSL Certificates interface (Home >> Service Configuration >> Manage Service SSL Certificates).

  • Your server's hostname must be valid and resolve in DNS.
  • Your server must have a valid cPanel & WHM license.
  • This system will only replace self-signed or expired certificates. It will not replace an existing valid certificate from a certificate authority.

You can disable the free cPanel-signed hostname certificate. You can configure this setting in Manage2's Update Company Information interface (Dashboard >> Company >> Update Company Information).

For more information, see the section on updated features in Manage2.

New service SSL certificate touch files

If you create the /var/cpanel/ssl/disable_auto_hostname_certificate touch file, the system will no longer order, download, and install a free cPanel-signed hostname certificate. The system will still automatically replace expired service certificates with self-signed certificates. 

If you create the  /var/cpanel/ssl/disable_service_certificate_management touch file, the system will disable all automatic replacement of expired service certificates and notifications about expired or expiring service certificates. You must use WHM's Manage Service SSL Certificates interface (Home >> Service Configuration >> Manage Service SSL Certificates) or the appropriate WHM API 1 functions to replace or renew them.

Manage Market Providers

In cPanel & WHM version 56, we added the Market Provider Manager interface (Home >> Market >> Market Provider Manager), which controls which providers appear in the cPanel Market. The server administrator can use this interface to select the certificate providers through whom they will allow their users to purchase certificates.

Currently, you can select the cPanel Store.

You can set the pricing per domain for each certificate in the cPanel Store, which follows the following conditions:

CertificateDefault PriceMinimum PriceMaximum PriceCommission Rate
cPanel DV$9.00$3.00$30.00one third of price
Comodo DV$12.00$12.00$120.00one third of price

  • Certificates that you offer through the cPanel store must cost a multiple of 12 cents.
  • Certificates that you offer through the cPanel Store automatically include each domain's www. subdomain for no additional cost. 

For information on how to build your own Market provider module, read our Software Development Kit.

You can disable the cPanel Store as a provider. You can configure this setting in Manage2's Update Company Information interface (Dashboard >> Company >> Update Company Information).

For more information, see the section on updated features in Manage2.


You can configure an account to receive a commission equal to one third of the certificate purchase price.

To collect any commissions from cPanel Market purchases through providers that offer commissions, server administrators must perform the following actions:

SSL/TLS Wizard

In cPanel version 56, we added the SSL TLS Wizard interface to cPanel (Home >> SSL/TLS >> SSL/TLS Wizard), which simplifies the process to purchase an install SSL certificates for domains. After you purchase certificates, the server will automatically configure and install the certificates on your domains.

If your server does not support SNI (for example, CentOS 5 and older), you can only purchase a single certificate to secure all of that account's domains, and the account must have a dedicated IP address.

  • cPanel users who want to purchase domains through this feature must register for a cPanelID.
  • Certificate and certificate provider availability depends on your location and hosting provider.
  • The cPanel Store will automatically email a copy of the certificate to the user. If the cPanel Store fails to redirect the user back to their account's SSL/TLS Wizard interface, the user can install the certificate manually.

Required features for SSL certificates

The SSL/TLS Wizard interface requires the following three features in WHM's Feature Manager interface (Home >> Packages >> Feature Manager):

Command line calls of API functions

In cPanel & WHM version 56, you can now call cPanel API 1, cPanel API 2, and UAPI functions from the command line.

We have added examples of how to perform a command line call to each function.

More information is available under the following SDK guides:

Integrated upgrades links

We added the upgrade option to the implements parameter in WHM API 1's create_integration_link integration function. The context-sensitive Upgrade link will appear in the appropriate interfaces when the user runs out of a resource, such as:

This allows your customers to use your billing system automation system to upgrade their account's resources and billing without the need to ask the system administrator for assistance.

DNS resolver performance monitoring

In cPanel & WHM version 56, the server now monitors the performance of your DNS resolvers, and it will send a notification when a resolver responds slowly or is unresponsive.

Security Advisor change notifications

In cPanel & WHM version 56, the system will send a notification when the state of a Security Advisor alert changes .

New notification templates

In cPanel & WHM version 56, we added more notifications to the new system. The following alerts are now available in WHM's Contact Manager interface (Home >> Server Contacts >> Contact Manager):

For the full list of available alerts, read our Contact Manager and Notification Templates documentation.

We strongly recommend that you review your Contact Manager settings to ensure that you will receive important server notices.

Team: Honey Badgers


Service Transfer Tool

In addition to expanding the WHM Transfer Tool interface's (Home >> Transfers >> Transfer Tool) ability to transfer, restore, or back up configurations, we now offer a new system configuration for the Service Transfer Tool on the UI. This feature offers you a simple way to select the configurations that you wish to transfer from a source server to your own server with ease.

As of cPanel & WHM version 56, the Transfer Tool allows you to transfer the following service configurations:

Also, we display the following warning message to all users to inform you of the End of Life (EOL) of CentOS 5 systems so that you can properly upgrade your server:

For CentOS 5 systems:

Your server currently runs the CentOS 5 operating system. Be aware that all CentOS 5 systems will reach their End of Life (EOL) on March 31, 2017. Before this date, you must migrate your system to a newer version of CentOS in order to receive security updates. For additional assistance on how to migrate your server to a server that runs a newer version of CentOS, read the Configuration section of the Transfer Tool documentation.

The Transfer Tool automates the migration experience and allows you to migrate configurations for multiple services. This saves you valuable time in the migration process.

For non-CentOS 5 systems:

The Transfer Tool automates the migration experience and allows you to migrate configurations for multiple services. This saves you valuable time in the migration process.

CentOS 5 Deprecation Warning

With the new extensions to WHM's Transfer Tool interface, we understand that not all users will be aware of the limitations on their systems. For this reason, we display a warning message to alert you that Red Hat® will deprecate all CentOS 5 systems on March 31, 2017. 

Team: Loose Cannon

Reset password for Subaccounts

With the introduction of Subaccounts in cPanel &WHM version 54, we have expanded the Reset Password feature to include Subaccounts. The Reset Password feature uses the Subaccount user's contact email address to process the password reset request. You can set each Subaccount user's Contact Email Address in cPanel's User Manager interface (Home >> Preferences >> User Manager). You can enable the Reset Passwords for Subaccounts feature in WHM's Tweak Settings - System interface (Home >> Server Configuration >> Tweak Settings). For more information, read our How to Reset a cPanel Subaccount Password documentation.

New Subaccount invites

cPanel's User Manager interface (Home >> Preferences >> User Manager) now allows you to send a welcome email to new Subaccounts during user creation. To use this feature you must enable the Reset Passwords for Subaccount option in WHM's Tweak Settings - System interface (Home >> Server Configuration >> Tweak Settings) and set the Subaccount's Contact Email Address in cPanel's User Manager interface.

Team: Phoenix

Site Publisher

cPanel's new Site Publisher interface (Home >> Domains >> Site Publisher) allows novice cPanel users to create simple websites from templates. 

New script

The /scripts/process_site_templates script processes template files and user-provided data to create an Site Publisher website.

cPanel Feature Showcase

A new Feature Showcase section will display above the Search text box the first time that users log in to cPanel after the server upgrades to cPanel & WHM version 56. We plan to use this section to showcase new and improved features in cPanel. To dismiss this section, click the X icon in the top corner.

Team: Release Team

Override customized installation settings

As of cPanel & WHM version 56, the installation process preserves the system defaults and user customizations in the /etc/bashrc, /etc/issue, and /etc/ files. To override these settings, run the /usr/local/cpanel/scripts/copy-etc-files script.

New script

The usr/local/cpanel/scripts/copy-etc-files script overrides the system defaults when you install cPanel & WHM.

Team: Spider-Pig

Implemented Convert Addon Domain to Account feature

In WHM version 56, we added the Convert Addon Domain to Account interface (Home >> Transfers >> Convert Addon Domain to Account).

This function allows root users and resellers to convert an addon domain into a cPanel account. When you convert an addon domain into a stand-alone cPanel account, you gain more control over the domain’s resources, such as databases, FTP accounts, SSH access, etc.

This release, the Convert Addon Domain to Account feature migrates the following account data:

Team: ZeroCool

EasyApache 4


EasyApache 4 now supports CloudLinux versions 6 and higher. If you wish to use EasyApache 4 with CloudLinux, read our How to Install or Uninstall EasyApache 4 documentation and CloudLinux's blog post

RPM update notifications

We created mailing lists and a notification system for EasyApache 4 RPMs so you can receive change notifications for our development and production branches. To subscribe to our mailing lists and receive updated information about EasyApache 4 RPMs, read our The EasyApache 4 git repository and build updates documentation for more information. 

Updated features

Team: Code Monkeys

Dormant mode

To reduce unnecessary memory consumption, we have expanded the availability of dormant mode for cPanel & WHM services. We have also updated both the new and existing dormant mode capabilities to ensure that Tailwatch checks do not wake dormant services or prevent dormant mode. If you have enabled dormant mode for a service, that service will immediately enter dormant mode whenever you reboot your server or restart the service.

You can now enable or disable the Dormant services setting in the Software section of WHM's Tweak Settings interface (Home >> Server Configuration >> Tweak Settings) for the following services:

The upgrade to cPanel & WHM version 56 will enable the Dormant services setting for all of these services. To disable this setting, use WHM's Tweak Settings interface (Home >> Server Configuration >> Tweak Settings).

  • Because cPanel & WHM stores this setting dynamically, we strongly recommend that you do not modify the value directly in the /var/cpanel/cpanel.config file.
  • If you use a custom dnsadmin plugin, you must disable the dnsadmin option.

Improved dnsadmin functionality

In order to properly handle it, we have updated the way in which cPanel & WHM manages the dnsadmin service.

Updated Perl environments and modules

We now compile cPanel binaries against Perl 5.22 instead of Perl 5.14.4. We have also updated all cPanel-included CPAN modules to ensure compatibility with Perl 5.22.

If you use custom Perl modules or Perl scripts on your server, or if you are a third-party developer, it is critical that you test your custom code against Perl 5.22 to ensure that it functions correctly. Modules that you built or used with Perl 5.14 may not work with the new cPanel & WHM version 56 binaries.

Removed '.' from @INC

For improved security, we have removed '.' from the @INC array. We updated the /usr/local/cpanel/bin/cpanm and /usr/local/cpanel/3rdparty/perl/522/bin/cpan utilities to properly handle this issue.

For more information, read our Prepare Perl Scripts for cPanel & WHM's Internal Perl and Guide to Perl in cPanel & WHM documentation.

New notification

The perl514 rpm.versions target is now deprecated. When you upgrade from cPanel & WHM version 54 to version 56, if the perl514 target is set to installed or unmanaged states in the rpm.versions system, you will receive a one-time email notification.

Team: Cobra

Purchase and Install an SSL Certificate interface changes

We changed WHM's Purchase and Install an SSL Certificate interface (Home >> SSL/TLS >>  Purchase and Install an SSL Certificate), which in earlier versions of WHM allowed the system administrator to purchase and install certificates from Trustwave®. System administrators who wish to purchase certificates for a user's website will now use this interface to select that user's account. The system will redirect them to the cPanel user's SSL/TLS Wizard interface (Home >> Security  >> SSL/TLS Wizard) in order to continue the purchase process.

  • If no cPanel Market providers are enabled, the system will automatically enable the cPanel Store provider.
  • If the cPanel user does not have the necessary features to use the SSL/TLS Wizard interface or install SSL certificates, the system will force override enable those features for the user:
    • market — cPanel Market.
    • sslinstall — SSL Host Installer.
    • tls_wizard — SSL/TLS Wizard.
  • Trustwave is not currently a provider available through the updated interface. If you wish to continue to use certificates from Trustwave or other certificate providers not listed in the Manage SSL Certificate Providers interface, you or your users must purchase and install those certificates manually.

External Authentication many-to-many

In cPanel & WHM version 56, you can link an external account to multiple cPanel accounts, WHM accounts, and Webmail accounts.

If your external account links to multiple system accounts, a new selector interface will appear after you click the Log In button for the external account. Select the linked system account that you wish to access or click Link Another Account to link a additional external account.

The selector interface only appears if your external authentication account links to multiple accounts. It will not appear if your external account only links to one system account. This is by design in order to preserve the rapid login process that External Authentication users currently enjoy.

If your external account links to only one system account and you wish to link an additional system account, perform the following steps:

  1. Log in as the desired system account.
  2. Navigate to cPanel's or Webmail's Password & Security interface (Home >> User Preferences >> Password & Security).
  3. Link the desired external account to the system account.

The selector interface will appear after you click that provider's Log In button.

If you do not select an account from the login selection interface, the access token from the external authentication provider will expire and you must log in again. If an external authentication provider does not set an expiration time, cPanel & WHM defaults to one hour.


For more information, read our How to Access cPanel & WHM Services documentation.

New identity provider modules

In cPanel & WHM version 56, we changed the Amazon, Google, and Facebook external identity provider modules from samples to normal modules. We have also added a PayPal provider module.

You can configure and activate these modules in WHM's Manage External Authentications interface (Home >> Security Settings >> Manage External Authentication).

Manually add External Authentication links

You can now manually add an External Authentication link to an account with the following two new API functions:

MariaDB username length

On servers that use MariaDB instead of MySQL, the following conditions apply:

Suspended accounts cannot send outbound mail

When you suspend a cPanel account on cPanel & WHM version 56, the mail server no longer allows that account's users to send outbound email through the mail server.

Also, the mail server will force all mail currently in the outbound message queue from that account's users to fail.

If the system administrator unsuspends the cPanel account, the mail server will allow that account's users to send mail again.

You cannot suspend the root user's outgoing email with this feature.

New UAPI and cPanel API 2 filter type

We added the ne filter type to UAPI and cPanel API 2, which allows you to filter output columns that do not equal the match value.

Feature and system performance improvements.

We improved the performance of the following features and systems:

Transfer Tool session timeout

In cPanel & WHM version 56, we added a control for Session Timeout to WHM's Transfer Tool interface (Home >> Transfers >> Transfer Tool). This sets the amount of time that the system will maintain an SSH connection to run without transfer activity.

In earlier version of cPanel & WHM, the session timed out after 15 minutes, which did not allow many source systems to properly package accounts. This setting now defaults to 30 minutes, and you can set a maximum value of 2 days.

Team: Honey Badgers

The cpconftool Script

We extended the capabilities of the cpconftool script to support the transfer of system configurations for Exim, cPanel themes, Apache, Backups, and MySQL. This script now allows for you to transfer, restore, or back up any set of configurations from the source server to a destination server. You can select one or multiple configurations. When you select the configurations that you wish to transfer, restore, or back up, the system will copy the existing files for that given configuration and perform the request.

Transfer Tool (TT)

WHM's Transfer Tool (TT) now can transfer all Exim, cPanel themes, Apache, Backups, and MySQL configurations from a source server. This new interface now allows you to transfer any set of configurations from a server. You can select one or multiple configurations. This new interface allows for you to copy multiple accounts from a remote server to your cPanel & WHM server. However, to transfer accounts, you must provide access to your server with root-level shell credentials.

Team: Loose Cannon

Reset Password

We have made significant improvements to cPanel's Reset Password feature. You can independently allow cPanel users and Subaccount users to reset their password. The password reset process includes a security improvement that requires the user to verify their contact email address. Additionally, the user can set their own password at the end of the reset process. You can enable the Reset Password feature for cPanel users and Subaccount users in WHM's Tweak Settings interface (Home >> Server Configuration >> Tweak Settings). For more information, read our How to Reset a cPanel Account Password or How to Reset a cPanel Subaccount Password documentation.

Team: Spider-Pig

Two-Factor Authentication no longer hidden by default in the WHM interface

We removed the restriction that hid the interface for Two-Factor Authentication in WHM. The icon and interface for the feature now appear to all users.

Team: ZeroCool

Standardized hooks

We added the following hookable Standardized Hooks to WHM:


cpconftool Support  — With the new extended capabilities of the cpconftool script we enhanced support within cpconftool for the Exim configurations. This ensures that all files transfer properly while adding additional configurations in the process.
EasyApache 4 Migration Script  — We implemented some new improvements within the EasyApache 4 migration script which increases the reliability of EasyApache 4 migrations to 99.98% in stock environments. You will experience faster run times, less waiting, and a more efficient and smooth system.
Apache Include Editor in WHM  — We corrected the bug that caused the Apache include editor in WHM to malfunction and not work properly.

Team: Loose Cannon

User Manager

cPanel's User Manager interface (Home >> Preferences >> User Manager) now allows you to unlink preexisting services from a Subaccount. For example, if you linked an existing FTP account to a Subaccount, you can unlink that FTP account in the User Manager interface. However, you cannot use the unlink option once you change the Subaccount's password and the interface will not display the Unlink option.

Team: Phoenix

Updated Feature Manager interface

WHM's Feature Manager interface (Home >> Packages >> Feature Manager) now includes links to quickly edit cPanel & WHM's default feature lists.

Updated Calendars and Contacts interface

cPanel's Calendars and Contacts Client Configuration interface (Home >> Email >> Calendars and Contacts Client Configuration) is now the Calendars and Contacts interface (Home >> Email >> Calendars and Contacts).

Team: Release Team

SquirrelMail ships as an RPM

As of cPanel & WHM version 56, SquirrelMail ships as an RPM. To customize your SquirrelMail RPM, follow the directions in the How to Build and Install Custom RPMs documentation.

Team: ZeroCool

EasyApache 4 Interface

We streamlined the EasyApache 4 user interface (Home >> Software >> EasyApache 4) to make it easier to use. 

Team: Adjective Animal

Manage2 interface

Manage2 now includes a setting to disable the cPanel Store as a provider in WHM's Market Provider Manager interface (Home >> Market >>  Market Provider Manager) interface. You also can block the installation of free cPanel-signed hostname certificates. You can configure these settings in Manage2's Update Company Information interface (Dashboard >> Company >> Update Company Information).

Deprecated and removed items

Team: Release Team

Removed Feature Manager option

We removed the legacy Statistics Program Manager setting from WHM's Feature Manager interface (Home >> Packages >> Feature Manager).

Removal of the Cpanel::Hulkd::Action file

In cPanel & WHM version 56, we removed the Cpanel::Hulkd::Action file.

Team: Spider-Pig

Removed Guess Email Addresses interface

We removed the Guess Email Addresses section from the Email All Users interface of WHM (Home >> Account Functions >> Email All Users). We deprecated this functionality in a previous release, and now the user interface reflects that change.

Deprecated Scripts




/usr/local/cpanel/ea2-tools/bin/ g77









Appendix A: Provided third-party applications


cPanel & WHM version 56 includes the following third-party applications:

PHP Modules

Perl Modules


cPanel & WHM uses the following operating system-provided third-party applications:

Appendix B: New and modified API calls

Modified cPanel API 2 calls

Team: Cobra

Team: Honey Badgers

New UAPI calls

Team: Cobra

Team: Loose Cannon

Team: Phoenix

Modified UAPI calls

Team: Cobra

Team: Loose Cannon

New WHM API 1 calls

Team: Cobra

Team: Spider-Pig


Modified WHM API 1 calls


Removed cPanel API 1 calls

There are no removed cPanel API 1 calls for this release.

Modified WHM API 0 calls

Team: Cobra