How to Rollback a cPanel Update

Unfortunately, you cannot rollback a cPanel update to a previous major version. This is a fundamental limitation of cPanel’s design. Once you’ve updated to a new major release (e.g., from version 100 to 102), there is no official process to revert to the older major version.

However, you can downgrade to a previous minor version within the same major release. This is typically done to fix compatibility issues that may have arisen from a recent, smaller update.

How to Downgrade a Minor cPanel Version via SSH

1. Log in to your server via SSH as the root user.
2. Edit the cpupdate.conf file. This file controls how cPanel updates itself. Use a text editor like nano:
   Bash

   nano /etc/cpupdate.conf
   

3. Specify the Target Version. Find the line that starts with CPANEL= and change its value to the specific older minor version you want to revert to. For example, if you are on 11.102.0.10 and want to go back to 11.102.0.8, the line should look like this:
   Bash

   CPANEL=11.102.0.8
   

4. Save and Exit. Save the changes to the file and exit the text editor.
5. Force the Downgrade. Run the following command to initiate the downgrade process. The --force flag is crucial as it overrides the normal update behavior to install the older version.
   Bash

   /scripts/upcp --force
   

   This script will re-run the update process and install the specified older version.

Important Considerations Before Downgrading

• Security Risks: Downgrading means you will miss out on critical security patches and bug fixes from the newer version. This can leave your server vulnerable to known exploits. It should only be done as a last resort for a specific troubleshooting purpose.
• Backup: Always perform a full backup of your server before attempting any major changes or downgrades. This includes your website files, databases, and configuration.
• Contact Support: If you’re experiencing issues after an update, your first step should always be to contact your hosting provider or cPanel’s technical support. They may have a known solution, a hotfix, or an alternative method that doesn’t require a risky downgrade.