Troubleshooting CyberPanel Inaccessibility After Ubuntu Release Upgrade
💡 Quick Summary (TL;DR):
- The Issue: Upgrading Ubuntu (e.g., via
do-release-upgrade) often breaks CyberPanel (port 8090) and OpenLiteSpeed WebAdmin (port 7080).- The Cause: Operating system upgrades change the default Python version (e.g., Python 3.8 to 3.10), which invalidates CyberPanel's virtual environment, Django dependencies, and systemd service paths.
- The Fix: Running the official CyberPanel upgrade script from the command line reinstalls the necessary dependencies for the new Python version and restores the services.
Upgrading your Ubuntu server is a crucial step to ensure your system remains updated with the latest features and security enhancements. However, such upgrades can sometimes lead to unexpected challenges, especially when dealing with web services like CyberPanel and OpenLiteSpeed or LiteSpeed Enterprise.
Generally, upgrading your operating system with CyberPanel already installed is discouraged as it can result in configuration errors. The official recommendation is to perform a clean installation on a fresh OS.
But what if you've already completed the upgrade and find yourself dealing with an unresponsive CyberPanel and LiteSpeed WebAdmin panel, as I encountered on a client's website after running the do-release-upgrade command? In this scenario, you may lose access to the CyberPanel admin interface (port 8090) and the LiteSpeed WebAdmin Panel (port 7080), making it a critical issue to address.
CyberPanel & LiteSpeed Ports Reference
| Port | Service | Process Name | Action if Inaccessible |
|---|---|---|---|
| 8090 | CyberPanel Admin Console | lscpd / gunicorn | Run upgrade script, check systemctl status lscpd |
| 7080 | LiteSpeed WebAdmin Console | lsws | Check systemctl status lsws, reset password via CLI if needed |
| 80 / 443 | Web Traffic (HTTP/HTTPS) | openlitespeed / lhttpd | Check website logs, verify listeners are active |
Why Does an Ubuntu Upgrade Break CyberPanel?
When you perform an OS release upgrade (such as upgrading from Ubuntu 20.04 LTS to 22.04 LTS), the default Python version of the operating system is updated (e.g., from Python 3.8 to Python 3.10).
CyberPanel is built on Python and Django. Because its services and virtual environments depend on specific Python library paths, the upgrade breaks these references. Crucial services like lscpd (the LiteSpeed Control Panel Daemon) fail to start because they can no longer find their Python dependencies.
Fortunately, running the CyberPanel upgrade script automatically detects the new Python environment, rebuilds the virtual environment, reinstalls Django dependencies, and updates the systemd unit files.
The Solution: Upgrading CyberPanel
Resolving the unresponsiveness of CyberPanel and the LiteSpeed WebAdmin Panel can be accomplished by executing an update for CyberPanel. At least this is how I solved my problem! Follow these steps to upgrade to the latest version and restore the dependencies:
Run the following command as the root user:
sh <(curl https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh || wget -O - https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh)
If you are using a sudo user instead of the root user, use this command instead:
sudo su - -c "sh <(curl https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh || wget -O - https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh)"
Once the upgrade process completes successfully, it will regenerate the Python environment, repair configuration mappings, and restart the lscpd and lsws daemons, restoring access to both admin panels.
Bu Yazıda Yapılan Değişiklikler
- 21.06.2026: Ubuntu sürüm yükseltme işleminden sonra CyberPanel'in bozulmasının asıl sebebi olan Python sürüm uyuşmazlığı ve virtualenv bozulması detayları eklendi. "Cyberpanel" kelimeleri "CyberPanel" olarak standardize edildi. Dil ve anlatım hataları düzeltildi. Port referans tablosu ile özet paneli eklendi.
