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.
- 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.
- 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
- 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).
ssh root@your-server-ip
Replaceyour-server-ip
with your actual server IP address.
Step 2: Execute the CyberPanel Utility Tool
cyberpanel_utility
, offering options for upgrades, addons, and more. This tool simplifies the upgrade process and ensures safety. To start the utility tool, enter:cyberpanel_utility
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
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:
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.6
and 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
Hi Madam,
You have written amazing article on this topic.
Please keep writing.
Thanks