Product Versions and the Release Process
To make decisions about updating your server, you must understand cPanel & WHM’s versions and releases.
You can’t downgrade a cPanel & WHM installation between major versions or release tiers.
A cPanel & WHM version number consists of three or four incremented integer values. Periods (
.) separate each value.
This version number contains the following parts:
The parent value is from our previous version numbering system and indicates a large group of major versions.
We deprecated this part of our numbering system in cPanel & WHM version 11.52.
In most cases, this value is optional.
You will usually only see this in configuration files, API function output, and RPM files.
Each major value indicates a new set of features. We often refer to the builds in this as a release or the major version.
Odd major values are development releases that appear on the EDGE release tier. For more information, read the More about LTS section below.
Even major values are production releases that appear in all release tiers.
Some references to version numbers may omit the minor value.
The minor value indicates sets of bug fixes and changes that stabilize the features in the major value version.
Initial builds of a production release use a minor value of
Later publications of the production release increment the build value.
Some references to version numbers may omit the build value.
The build value indicates a unique build of cPanel & WHM.
We release versions of cPanel & WHM across several architectures. We also may publish several versions across different tiers on the same day.
- If your server uses the RELEASE, STABLE, or LTS tiers, the system applies a delay of several business days before your automatic upgrade occurs. For more information, read our Update Preferences documentation.
- Whenever possible, we do not release new versions on international holidays and weekends (Thursday evening through Sunday afternoon).
We release cPanel & WHM through five publicly-available tiers. This allows server owners to select their preferred update frequency as we develop and publish new versions of cPanel & WHM.
- Use WHM’s Update Preferences interface (WHM >> Home >> Server Configuration > Update Preferences) to select a release tier.
- When a release of cPanel & WHM no longer exists in any tier and reaches End of Life (EOL), it becomes unsupported. Unsupported versions don’t receive security updates or bug fixes.
You can choose from the following release tiers:
Long-Term Support (LTS). Use this tier to select a single cPanel & WHM version for the year during which cPanel, L.L.C. supports it. We only ship one LTS version per year.
For more information, read the More about LTS section below.
This version has undergone public exposure, testing, and verification. We publish this tier less often than RELEASE.
New installations default to this tier.
This version is feature-complete and we have tested it thoroughly. It contains all intended features and functionality. We publish this tier more often than STABLE.
This version has received verification and testing. We publish this tier more often than RELEASE.
Some of this version’s features may still be in development.
This tier represents the “Release Candidate” tier that other publication schedules use.
Due to the dynamic nature of EDGE builds, only use EDGE for testing in a controlled environment. We do not recommend this tier for production servers.
This version has only received rudimentary testing. We publish this tier most often (up to several times per week).
This version contains features that we plan to change further.
This version may not include all features or official public documentation.
Production release process
We use the following process to develop and manage production releases:
We complete development and testing of the production release.
We publish the release to the development and EDGE tiers.
We publish the release to the CURRENT tier. At this point, we stop developing or publishing non-critical changes to those releases.
After the release enters the RELEASE tier, we assess any immediate maintenance needs.
After we resolve those maintenance needs, we publish to the STABLE and, annually, LTS tiers.
In addition to everything in the previous production release, development releases of cPanel & WHM include changes from the next planned production release. We publish all development release changes to the EDGE tier.
More about LTS
Long-Term Support (LTS). Use this tier to select a single cPanel & WHM version for the year during which cPanel, L.L.C. supports it. We only ship one LTS version per year (usually in January).
Over the lifespan of an LTS release, cPanel, L.L.C. will provide security and other critical updates. We won’t add new features to LTS releases unless they’re critical. We also provide updates for compatibility with later versions.
Only one release each year qualifies for LTS. Other versions will only receive updates in the STABLE, RELEASE, CURRENT, or EDGE tiers.
We follow these guidelines to provide LTS support:
The lifespan of each release extends through March 31st of the following year.
cPanel, L.L.C. may extend a version’s LTS period at our discretion.
Development releases of cPanel & WHM do not qualify for LTS. We don’t use their publication dates to calculate an LTS version’s lifespan.
LTS updates for other applications
We provide LTS updates for the following applications:
cPanel & WHM provides various third-party applications. For supported LTS releases, we provide critical updates for third-party applications. We may provide them as backported patches instead of upgrades.
cPanel, L.L.C. releases EasyApache separately from cPanel & WHM’s release schedule. We provide EasyApache updates for an LTS release until the LTS release reaches End of Life (EOL).
If the LTS version doesn’t meet EasyApache’s requirements, EasyApache will update. However, we can’t support that update.
EasyApache uses the php.net supported versions timeline. RPMs for unsupported versions of PHP will remain on the cPanel, L.L.C. mirrors and servers. We will not provide any further updates.
cPAddons and WHM plugins
We release updates for cPAddons and WHM plugins throughout the LTS release’s lifetime.