Guide CloudPanel Installation Failed? Common Install Errors and How to Fix Them - Printable Version +- AdminsForum (https://adminsforum.com) +-- Forum: Free & open-source control panels (https://adminsforum.com/Forum-free-open-source-control-panels) +--- Forum: CloudPanel (https://adminsforum.com/Forum-cloudpanel) +---- Forum: CloudPanel Guides & Tutorials (https://adminsforum.com/Forum-cloudpanel-guides-tutorials) +----- Forum: CloudPanel Getting Started Guides (https://adminsforum.com/Forum-cloudpanel-getting-started-guides) +----- Thread: Guide CloudPanel Installation Failed? Common Install Errors and How to Fix Them (/Thread-guide-cloudpanel-installation-failed-common-install-errors-and-how-to-fix-them)

CloudPanel Installation Failed? Common Install Errors and How to Fix Them - JAY - 10-23-2026 CloudPanel installation failed? Common install errors and how to fix them CloudPanel installs with one command, and most of the time it just works. When it doesn't, the installer usually stops with a short message and leaves you guessing. This guide covers the errors people hit most, what they mean and how to get a clean install. Before anything else: use the current install command CloudPanel's install command contains a checksum (a long code) that matches the installer version. The checksum changes when CloudPanel releases a new installer, so always copy the full command from the official CloudPanel installation page instead of an old blog post. It looks like this (the checksum here is an example): Code:Copy curl -sS https://installer.cloudpanel.io/ce/v2/install.sh -o install.sh; \ echo "CHECKSUM install.sh" | sha256sum -c && sudo DB_ENGINE=MYSQL_8.4 bash install.sh And always update the system first: Code:Copy apt update && apt -y upgrade && apt -y install curl wget sudo Error 1: "install.sh: FAILED" / "computed checksum did NOT match" The installer you downloaded doesn't match the checksum in your command. Either your command is old, or the download was cut off. Delete the file ( Code:Copy rm install.sh ) and run the current command from the docs again. Never remove the checksum check to "make it work"; it protects you from a tampered installer. Error 2: unsupported operating system CloudPanel only installs on the Ubuntu and Debian versions listed on its requirements page (recent LTS releases such as Ubuntu 24.04 and Debian 12). CentOS, AlmaLinux, Rocky, Ubuntu 20.04 and other systems won't work. Check yours: Code:Copy cat /etc/os-release | head -3 uname -m If the OS is wrong, reinstall the VPS with a supported image from your provider's panel. Both x86_64 and ARM (aarch64) servers are supported. See CloudPanel system requirements. Error 3: "Could not get lock /var/lib/dpkg/lock-frontend" Another package job is running, usually the automatic security updates that start right after a new VPS boots. Wait a few minutes and check: Code:Copy ps aux | grep -E 'apt|dpkg|unattended' | grep -v grep When nothing is listed, run the installer again. Don't delete the lock files while a job is still running; that can break the package database. Error 4: the server isn't empty CloudPanel needs a fresh, empty server. If Apache, Nginx, MySQL, another control panel or an earlier half-finished CloudPanel install is already there, the installer can fail or leave a broken setup. Check what is running on the web and database ports: Code:Copy ss -tlnp | grep -E ':80 |:443 |:3306 |:8443 ' If anything shows up, the cleanest fix is to reinstall the VPS with a clean OS image and run the CloudPanel installer first, before you add anything else. Error 5: the install is killed halfway or the server freezes Usually not enough memory. Installing the database server is the heaviest step. Check your RAM and swap: Code:Copy free -h On a small VPS (1 GB), add a 2 GB swap file before installing: Code:Copy fallocate -l 2G /swapfile && chmod 600 /swapfile && mkswap /swapfile && swapon /swapfile echo '/swapfile none swap sw 0 0' >> /etc/fstab Also check free disk space with Code:Copy df -h / . Leave plenty of room for the database and your sites. Error 6: downloads fail (DNS or network) Messages like "Could not resolve host" or timeouts mean the server can't reach the internet properly. Test: Code:Copy ping -c 2 installer.cloudpanel.io curl -I https://installer.cloudpanel.io If names don't resolve, check Code:Copy /etc/resolv.conf or set your provider's DNS servers. If you run the installer as a normal user, use Code:Copy sudo or log in as root. Right after a successful install Open Code:Copy https://YOUR_SERVER_IP:8443 immediately and create the admin user. Until you do, anyone who finds the page could create it. Your browser will warn about a self-signed certificate on first visit; that's expected. Can't reach the page? See Can't log in to CloudPanel in this section. Still stuck? Post the last 20 lines of the installer output, your OS ( Code:Copy cat /etc/os-release ) and Code:Copy free -h in this section. Sources: CloudPanel: installation More CloudPanel troubleshooting Can't log in: port 8443, password and 2FA Site shows 403 Forbidden or 404 Too many redirects or mixed content after SSL PHP extension missing / enable ionCube WordPress asks for FTP or can't update plugins Varnish showing old pages or breaking logins Restore a site from a backup SSH or SFTP login fails Node.js app shows 502 or keeps restarting Site hacked: find malware and clean up clpctl errors: not found, wrong user, quoting Applies to CloudPanel v2 on Ubuntu and Debian, October 2026.