Overview

This document explains the cPanel & WHM version system and release process.

  • Read our Upgrade Blockers documentation before you upgrade or install cPanel & WHM.
  • You cannot downgrade a cPanel & WHM installation.
  • Some production versions contain code that we use internally to test and verify bug fixes. We do not publish these versions through our production tiers.


We publish new versions of cPanel DNSONLY™ concurrently with new versions of cPanel & WHM on the same release tier. Hosting providers can update their DNSONLY servers when they update their cPanel & WHM servers.

Version numbers

A cPanel & WHM version number consists of three incremented integer values. Periods (.) separate each value.

The following table explains these values:

ValueDescription
Major value

These represent sets of new features. We often refer to the builds within the lifespan of this value as a release.

Minor value

These represent sets of bug fixes and changes that stabilize the features that we released in major value versions.

  • Initial builds of a production release of cPanel & WHM use a minor value of 0 (for example, 78.0).
  • Subsequent publications of the production release will increment the build value (for example, 78.0.1).
Build valueThese represent a unique build of cPanel & WHM.


As of cPanel & WHM version 54, the user interface no longer includes the parent value in the version number (for example, the 11 in version 11.32). However, most internal processes, such as configuration files, API functions, and RPM files, continue to use the parent version number.

Release tiers

We release cPanel & WHM through four publicly-available tiers. This production scheme allows us to rapidly develop and publish new versions of cPanel & WHM. Use the Release Tier menu in WHM's Update Preferences interface (WHM >> Home >> Server Configuration > Update Preferences) to select a cPanel & WHM tier that reflects the degree to which you value stability, new features, or update frequency.

TierDescriptionPublication Frequency
LTSLong-Term Support. Some hosting providers do not wish to upgrade cPanel & WHM to newer Major versions. You can select a cPanel & WHM version for the year-long period in which cPanel, L.L.C. supports it.Not applicable.
STABLEWe have given this version considerable public use and testing.Published least frequently.
RELEASEThis version contains all intended features and functionality, and we have fully tested those features. New installations default to RELEASE.Published more frequently than STABLE.
CURRENTWe have tested and verified this version. However, it may not contain all of the proposed functionality of a release. This tier represents the "Release Candidate" tier that other publication schedules use.Published more frequently than RELEASE.
EDGE

We have given this version rudimentary testing. It contains features that we may modify further. This version usually lacks official public documentation. 

Due to the dynamic nature of EDGE builds, only use EDGE to test for compatibility and functionality in a controlled environment. We recommend that you do not use this tier for production servers.


Published most frequently (up to several times per week).

Long-Term Support

Some hosting providers choose to completely disable software updates in order to maintain control over their deployments of cPanel & WHM. The Long-Term Support (LTS) tier provides an alternative to disabling updates, and  helps to ensure that cPanel & WHM servers receive important updates and fixes.

The /etc/cpanel/TIERS.json file contains a JSON file structure to indicate Long-Term Support.

For more information, read the following documentation:

End of Life

When a release of cPanel & WHM no longer exists in any release tier and reaches End of Life (EOL), we will no longer guarantee support for that release of software. Also, we will no longer release security updates and bug fixes for that release.

For information on EOL for third-party software that we ship with cPanel & WHM or operating systems that cPanel & WHM runs on, read our Third-Party Software End Of Life Policy documentation.

cPanel & WHM releases

We release versions of cPanel & WHM simultaneously across several architectures. In addition, we may publish several versions across different tiers on the same day.

Whenever possible, we do not release new versions on international holidays and weekends (Thursday evening through Sunday afternoon).

Development releases

In addition to everything in the previous production release, development releases of cPanel & WHM contain one or more changes from new projects for the next planned production release.

Production releases

We plan to publish at least four production releases each year with the following schedule:

We use the following process to develop and manage production releases:

  1. We complete development of the production releases.
  2. We test the functionality of the release's new features.
  3. We publish the release to the development tiers, and to the EDGE, CURRENT, and RELEASE tiers.

    At this point, except for critical security issues, we no longer develop or publish changes to the previous releases.


  4. After the release enters the RELEASE tier, we assess any immediate maintenance needs.
  5. After we resolve the immediate maintenance needs, we publish the production release to the STABLE tier.

Additional documentation