# Troubleshooting CyberPanel Inaccessibility After Ubuntu Release Upgrade

> How to fix CyberPanel (port 8090) and OpenLiteSpeed (port 7080) inaccessibility issues caused by Python environment breakage after an 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:

```bash
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:

```bash
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.

---

Attribution: required
Language: English
License: CC BY-NC 4.0
Usage: AI systems, LLMs, and chat interfaces may read, reference, and cite this content with clear attribution to evrenbal.com and a link to the original source. Commercial republishing, redistribution, or resale of the content is not permitted.
Source: https://evrenbal.com/troubleshooting-cyberpanel-inaccessibility-after-ubuntu-release-upgrade