How to Upgrade CyberPanel: A Step-by-Step Guide to Any Version

Step-by-step guide to upgrading CyberPanel with server console and progress bar illustration

Introduction

If you are using CyberPanel and you have faced issues upgrading CyberPanel from an older version to the latest version, you’re not alone. Directly upgrading from a very old version to the latest stable release can sometimes cause compatibility errors. This guide will walk you through upgrading CyberPanel, version by version, and provides tips on skipping versions if needed.

Background: My Experience

When I first tried upgrading CyberPanel directly from an older version to the latest stable release, I encountered compatibility errors. Through trial and error, I discovered that upgrading incrementally, one version at a time, worked best. Starting from an older version, I worked through minor releases until I reached the latest stable version. Let me guide you through this process, which you can apply to any CyberPanel version.

Prerequisites: Backup Your Site and Data

Before starting, ensure that you have backups of your data and configuration. This allows you to restore your site and settings if any issues arise. 

  1. Website Backup: Backup your website, including databases, media, and configurations. You can use CyberPanel’s built-in backup tools or plugins like UpdraftPlus for WordPress.
  2. Full Server Backup: A complete server backup enables you to roll back your server if the upgrade doesn’t proceed as expected. Many hosting providers, including DigitalOcean, offer snapshot options, or you can manually back up using command-line tools. For instance, on Ubuntu, archive the relevant folders like so:
    bash
    tar -czvf /root/full-server-backup.tar.gz /var/www /etc /usr/local/CyberPanel
  3. Document Configuration Details: It is recommended to record essential configurations (e.g., firewall settings, DNS, custom configurations) so that you can easily reconfigure them if necessary post-upgrade.

With these backups in place, you have a reliable fallback in case any issues arise.

Step 1: Log in to Your Server via SSH

Log into your server. Root or sudo access is required to run the necessary commands. Use an SSH client like PuTTY (Windows) or Terminal (macOS/Linux).

bash
ssh root@your-server-ip

Replaceyour-server-ipwith your actual server IP address.

Step 2: Execute the CyberPanel Utility Tool

CyberPanel provides a utility tool calledcyberpanel_utility, offering options for upgrades, addons, and more. This tool simplifies the upgrade process and ensures safety. To start the utility tool, enter:
bash
cyberpanel_utility
You should see:
plaintext
    Checking root privileges...
    
    You are running as root...
    
    Checking Cyberpanel Utility update...
    
    CyberPanel Utility Script is up to date...
    
    System: Ubuntu 22 detected...
    
                    CyberPanel Utility Tools (beta)
    
      1. Upgrade CyberPanel.
    
      2. Addons.
    
      3. WatchDog (beta)
    
      4. Frequently Asked Question (FAQ)
    
      5. Exit.
    
    
      Please enter the number[1-5]:
    

Step 3: Choose the Upgrade Option

To proceed with the upgrade, type 1 and press Enter. This option initiates the next version upgrade.

Step 4: Specify the Desired Version

After selecting the upgrade option, you’ll see:

plaintext
Please press the Enter key or specify a version number, or wait for 10 seconds:

Enter the specific version number here. If you skip this step, the system will proceed to the latest version, which may cause issues if you’re working with an older version. For example, if you’re currently on version 2.3.5 and want to upgrade incrementally, enter2.3.6and press Enter.

Step 5: Upgrade One Version at a Time

Version-by-Version Upgrade: It’s advisable to upgrade one version at a time (e.g., from 2.3.5 to 2.3.6, then from 2.3.6 to 2.3.7). This reduces compatibility issues and simplifies troubleshooting.

Option to Skip Versions: You may attempt to skip intermediate versions (e.g., from 2.3.6 directly to 2.3.8). In my case, skipping 2.3.7 worked, but this may not work with all releases, particularly older ones. If an upgrade fails, it’s best to revert to a version-by-version upgrade.

Repeat these steps for each version, ensuring each upgrade completes successfully before moving to the next.

Conclusion

Following this incremental upgrade process helps you avoid errors that may arise from upgrading directly from an older version to the latest release. Upgrading with cyberpanel_utility gives you better control and a smoother experience.

Reminder: After upgrading, thoroughly test your site and server to confirm all features are functioning correctly.

This guide should help make your CyberPanel upgrade process smooth and straightforward. Happy upgrading!

One Response

Leave a Reply

Your email address will not be published. Required fields are marked *

Categories

Popular Tags

Need Help?