How to install CyberPanel on Ubuntu or AlmaLinux

CyberPanel is a hosting control panel built on OpenLiteSpeed. You install it with a single script, answer a few prompts, and get a browser panel on port 8090 that manages websites, mail, DNS and databases. This guide walks through the install on a fresh Ubuntu or AlmaLinux VPS, the OpenLiteSpeed versus LiteSpeed Enterprise choice, and the first login.

The installer is interactive and takes a while, so read the prompts before you start clicking. On a clean server it usually finishes without manual fixes.

Before you start

You need a few things in place first:

• A Linux VPS running a supported release. CyberPanel supports specific Ubuntu and AlmaLinux versions, and that list changes over time, so check the CyberPanel documentation for the current supported OS list before you build the server. Ubuntu 22.04 or 24.04 and AlmaLinux 8 or 9 are common choices.
• Root access, or a sudo user. The installer must run as root. If you have not created one yet, see create a sudo user on Linux.
• A working SSH session. If this is your first connection, read connect to your Linux VPS with SSH.
• A fresh server. CyberPanel installs its own web server on ports 80 and 443. If Apache, Nginx or another panel is already there, stop and remove it first or the install will fail.
• A hostname that resolves to your VPS IP, for example panel.example.com. Useful for the SSL certificate later, not required for the install.

Log in to your VPS, then check your IP and OS version:

whoami
cat /etc/os-release
ip -4 addr show scope global

You should see root (or your sudo user) and the distribution name.

Run the installer inside screen or tmux

The install can take 10 to 30 minutes. If your SSH connection drops, the script dies halfway and leaves a broken set of packages. Start a terminal multiplexer first:

# Ubuntu / Debian
apt update && apt install -y screen tmux

# AlmaLinux / Rocky
dnf install -y screen tmux

Then open a session:

screen -S cyberpanel

Detach at any time with Ctrl+A then D, and reattach with screen -r cyberpanel. If you prefer tmux, use tmux new -s cyberpanel and detach with Ctrl+B then D.

Install CyberPanel on Ubuntu or AlmaLinux

Update the system, then run the official installer as root.

# Ubuntu / Debian
apt update && apt -y upgrade

# AlmaLinux / Rocky
dnf -y update

Now run the install script:

sh <(curl -s https://cyberpanel.net/install.sh || wget -qO - https://cyberpanel.net/install.sh)

If the command fails because curl and wget are both missing, install one of them first (apt install -y curl or dnf install -y curl) and try again.

The script prints the terms of use and asks you to accept them. Then it shows the install type menu, which looks roughly like this:

1. Install CyberPanel with OpenLiteSpeed
2. Install CyberPanel with LiteSpeed Enterprise
3. Exit

Enter 1 for OpenLiteSpeed unless you have a LiteSpeed licence.

Next it asks whether to install the full package set (PowerDNS, Postfix, Pure-FTPd and similar). Enter y for a normal hosting setup. The script asks a few more questions, including whether to use a remote database and whether to install a firewall such as CSF. Accepting the default full install is the least surprising path.

From here the script runs on its own. Expect package downloads, OpenLiteSpeed compilation checks and service starts. Do not close the SSH session.

When it finishes, the script prints a summary with:

• the panel URL, normally https://203.0.113.10:8090 or https://panel.example.com:8090
• the admin username (admin)
• a generated admin password

Copy the password somewhere safe now.

Open the firewall for the panel

If you run UFW or firewalld on the VPS, allow the ports CyberPanel needs before you try to log in. On Ubuntu with UFW:

ufw allow 8090/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw reload
ufw status

On AlmaLinux with firewalld:

firewall-cmd --permanent --add-port=8090/tcp
firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https
firewall-cmd --reload
firewall-cmd --list-all

The installer may also install its own firewall (CSF). If it did, allow port 8090 there too, or the panel will stay unreachable from your browser. Full walkthroughs: UFW on Ubuntu and Debian and firewalld on AlmaLinux and Rocky.

Log in and confirm the install worked

Open the panel address in your browser. Port 8090 uses HTTP by default, and the installer may already have requested a Let's Encrypt certificate for your hostname.

https://203.0.113.10:8090

Accept the certificate warning if the panel is still on a self-signed certificate. Log in with admin and the password from the install summary.

On the command line, confirm the services are running:

systemctl status lscpd --no-pager
systemctl status lsws --no-pager
ss -ltnp | grep -E '8090|7080|80|443'

You should see lscpd and lsws as active (running), and listeners on 8090 (panel) and 80/443 (websites). OpenLiteSpeed's own admin console listens on 7080.

Then create a test site in the panel, publish a simple index.html, and load it over HTTP. If the page renders, the panel and the web server are wired together correctly.

If you lose the admin password, reset it from the CyberPanel CLI or follow the current reset steps in the CyberPanel docs — the exact command has changed between releases.

Troubleshooting

• Install script exits with "unsupported OS" or an OS check failure. Your distribution or version is not on the supported list. Rebuild the VPS with a supported Ubuntu LTS or AlmaLinux release rather than forcing the install.
• Cannot open the panel URL. A local firewall is blocking port 8090, or your cloud provider's network firewall is. Check ufw status or firewall-cmd --list-all and open 8090, then check the provider console. See firewalld on AlmaLinux and Rocky.
• Install stops at the web server or database step. Usually a leftover Apache, Nginx or MariaDB install on the same ports. Run the installer on a clean VPS, or stop and remove the conflicting service before retrying.
• The SSH session dropped mid-install. Reattach with screen -r cyberpanel if the process survived. If it did not, the server is in a half-installed state; the cleanest fix is to reinstall the OS from your VPS provider's control panel and start again.
• Panel loads but sites return 503 or a blank page. The site's PHP handler or document root is wrong. Check the site's error log under Logs in CyberPanel and confirm the correct PHP version is assigned to the domain.

Next steps

With CyberPanel running you can add websites, mail domains and databases from the panel. A few guides that pair well with it:

• How to install OpenLiteSpeed web server on Ubuntu if you want to understand the web server underneath the panel.
• Install and secure MariaDB or MySQL for database access from outside the panel.
• Transfer files to your Linux VPS with SCP or SFTP to upload site files and backups.
• How to install Plesk on a Linux VPS if you would rather compare panels before committing.