Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
minLevel2
stylenone

Overview

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

Warning
titleImportant:
  • 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.


Note
titleNote:

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.


Note
titleNote:

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.

Anchor
ReleaseTiers
ReleaseTiers
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. 

Warning
titleWarning:

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.

Anchor
cpanelreleases
cpanelreleases
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.

Note
titleNote:

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.

  • We publish all development release changes to the EDGE tier.
  • We only publish tested and verified development release changes to the CURRENT tier.
  • We do not publish development release changes to the STABLE or RELEASE tiers.

Production releases

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

  • We publish the first production release around January.
  • We publish the second production release around April.
  • We publish the third production release around July.
  • We publish the fourth production release around October.

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.

    Note
    titleNote:

    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

Localtab Group


Localtab
activetrue
titleSuggested documentation

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("versions","tiers","updates") and label in ("cpanel","whm","dnsonly") and space = currentSpace()


Localtab
titleFor cPanel users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("versions","tiers","updates") and label = "cpanel" and space = currentSpace()


Localtab
titleFor WHM users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("versions","tiers","updates") and label = "whm" and space in (currentSpace(),"DOC")


Localtab
titleFor developers

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("versions","tiers","updates") and space = "DD"