Install ZoPanel
Install ZoPanel with one command, choose components and options with flags, run it unattended from cloud-init, and sign in at https://IP:8888.
ZoPanel installs with a single command on a fresh Ubuntu or Debian server. The installer brings the system up to date, sets up the web stack and starts the panel. Check the system requirements first.
Install (verified, recommended)
The installer runs as root, so check that it is the one ZoPanel signed before running it. Every release signs install.sh with the ZoPanel release key (Ed25519); the signature is install.sh.sig, next to it. Connect to the server over SSH as root (or a sudo user) and run:
# 1. The ZoPanel release public key
cat > zopanel-release.pem <<'EOF'
-----BEGIN PUBLIC KEY-----
MCowBQYDK2VwAyEAXitZpY6gmHkZfPC0eIgXnZSEP+tPpPa9fLeG8qffFPA=
-----END PUBLIC KEY-----
EOF
openssl pkey -pubin -in zopanel-release.pem -outform DER | tail -c 32 | sha256sum
# must print d4c4627386074287116cfe7028a8a32b1c632303f1a3157b23e1e1def574a6a4
# 2. The installer and its signature
curl --proto =https --tlsv1.2 -fsSLO https://update.zopanel.net/install.sh
curl --proto =https --tlsv1.2 -fsSLO https://update.zopanel.net/install.sh.sig
# 3. Verify, and run only if the signature is good
base64 -d < install.sh.sig > install.sh.sig.bin
openssl pkeyutl -verify -pubin -inkey zopanel-release.pem -rawin -in install.sh -sigfile install.sh.sig.bin \
&& sudo bash install.sh
openssl must print Signature Verified Successfully; on anything else the installer does not run. To pass options, put them after install.sh:
sudo bash install.sh --php 8.3,8.2 --admin-email you@example.com
The check is only as good as the key you check with: compare the fingerprint d4c4627386074287116cfe7028a8a32b1c632303f1a3157b23e1e1def574a6a4 with a copy you got some other way than this page (the ZoPanel README, or a copy you saved earlier), then keep zopanel-release.pem and reuse it for every server instead of copying it again. The same key is built into every ZoPanel binary and the installer, which then checks the signed release manifest, the binary's SHA-256 and size, installs /usr/local/zopanel/bin/zopanel and runs zopanel setup with your options. openssl pkeyutl -rawin needs OpenSSL 3, which every supported system (Ubuntu 22.04+, Debian 12+) has.
Quick install (one line, unverified)
curl -fsSL https://get.zopanel.net | sudo bash
This runs whatever the download server sends as root, before anything is checked: if that server or its TLS certificate were compromised, a modified script would run unnoticed. The steps the installer takes afterwards (signed manifest, binary checksum) are only as trustworthy as the script itself. Use it on throwaway test servers; for anything else use the verified install above. The examples below use sudo bash install.sh after that check; with the one-line form, put the options after sudo bash -s --.
What the installer does
The installer prints each step as it runs:
- Checking system: supported OS and architecture, RAM, and no other web server or control panel.
- Updating the system:
apt updateand a full upgrade of all packages, retried up to 3 times. It then turns on automatic security updates (unattended-upgrades) and handles the kernel (see below). - Installing packages: nginx, MariaDB, UFW, Fail2ban, quota tools, OpenSSH and the PHP repository (ondrej PPA on Ubuntu, packages.sury.org on Debian).
- Installing PHP: the versions from
--php, plus wp-cli. - Installing language runtimes: Node.js 22, Composer and Python by default.
- Creating users and directories: the
zopanelsystem user and the hosting groups. - Configuring nginx, MariaDB (buffer pool at 20% of RAM, swap on small servers) and SFTP (chrooted).
- Configuring firewall and fail2ban: UFW with your SSH port, 80, 443 and 8888 open; Fail2ban for SSH and the panel login.
- Enabling disk quotas and hiding processes between accounts.
- Installing ZoPanel: configuration, a self-signed certificate, the first administrator, the
Basic,BusinessandPropackages and thezopanelandzopanel-agentservices.
Optional components and a license key are then queued for the panel, which installs or activates them in the background after it starts.
The installer is safe to run again: it repairs the configuration without touching your data, and keeps existing administrator accounts.
Kernel handling
ZoPanel can compress customers' idle memory in RAM on Linux 6.8 or newer. If the running kernel is older:
| System | What happens |
|---|---|
| Ubuntu 22.04 | Ubuntu's HWE kernel (linux-generic-hwe-22.04) is installed by default |
| Debian 12 | The installer asks whether to install the 6.12 backports kernel (default: no). It is outside Debian's security support. |
| Ubuntu 24.04, Debian 13 | Already on a 6.8+ kernel: nothing to do |
| Containers | The host's kernel is used: nothing to do |
You can change your mind later: the Tuning page shows the command to install a newer kernel.
The restart question
When a new kernel or system libraries need a restart, the installer asks once, near the start:
A restart is needed to finish (new kernel or system libraries). Restart automatically
when the installation is done? [Y/n]
If you answer yes, the server restarts 15 seconds after the installer finishes and ZoPanel starts by itself. Queued components are installed after the restart. If you answer no, restart later with reboot to finish the update.
Installer options
| Flag | Default | What it does |
|---|---|---|
--profile web|full |
web |
web: the web stack only. full: also mail, webmail, calendars & contacts, DNS, WAF, Apache (.htaccess), FTP, PostgreSQL, Adminer and Docker. |
--with LIST |
none | Extra components, comma separated: mail, webmail, dav, dns, waf, apache, ftp, postgres, mongo, adminer, docker, storage. |
--php VERSIONS |
8.3 |
PHP versions to install, comma separated (7.4 to 8.4). The first becomes the default. |
--admin-user NAME |
admin |
Login name of the first administrator. |
--admin-email EMAIL |
none | Administrator email, used for Let's Encrypt and notifications. |
--hostname HOST |
system hostname | Server hostname. |
--mail-hostname HOST |
none | Mail server hostname, needed for mail and webmail. If omitted and --hostname has at least three labels (like srv1.example.com), that hostname is used. |
--nameservers LIST |
none | Nameservers for the DNS server, needed for dns. |
--license KEY |
none | License key to activate once the panel runs. |
--runtimes LIST |
node22,composer,python |
Language runtimes to install (node<major>, python, composer). Go and other runtimes are installed later from Runtimes in the panel. |
--yes |
off | Ask nothing; defaults apply. No restart unless --reboot is also given. |
--reboot |
off | Restart automatically at the end when a restart is needed. |
--no-reboot |
off | Never restart; just say when a restart is needed. |
--keep-kernel |
off | Never install a newer kernel. |
--kernel-backports |
off | Debian 12: install the 6.12 backports kernel without asking. |
--no-os-upgrade |
off | Leave the system packages as they are (also skips automatic security updates and the kernel). |
--allow-no-firewall |
off | Continue when the firewall (UFW) cannot be enabled. Without it the setup stops there, since databases, Redis and apps that listen on every address would be reachable from the internet. Use it only when another firewall (your provider's) filters the traffic; the Security Center then reports the firewall off. Also ZOPANEL_ALLOW_NO_FIREWALL=1. |
--force |
off | Continue on an unsupported system or one with another web server. On an operating system other than Ubuntu 22.04/24.04/26.04 or Debian 12/13, also set ZOPANEL_FORCE=1 (see the notes). |
Notes:
--rebootand--no-rebootcannot be used together.- If
mail/webmailis chosen without a mail hostname, ordnswithout nameservers, that component is skipped with a message; install it later from Components. - To keep secrets out of the process list, pass the license as
ZOPANEL_LICENSE_KEYand a chosen admin password asZOPANEL_ADMIN_PASSWORDinstead of flags. Without a password, a random one is generated. - Without a terminal, questions take their default answer.
- The download script stops on an unsupported operating system before it reads any flag, so
--forcealone does not get past that check. SetZOPANEL_FORCE=1as well:sudo ZOPANEL_FORCE=1 bash install.sh --force.
Examples
A full server with mail and DNS:
sudo bash install.sh \
--profile full \
--hostname srv1.example.com \
--admin-email admin@example.com \
--mail-hostname mail.example.com \
--nameservers ns1.example.com,ns2.example.com
Two PHP versions and a license:
sudo bash install.sh --php 8.3,8.2 --license ZP-XXXX-XXXX-XXXX
Unattended install (cloud-init)
Use --yes so nothing is asked, and decide the restart with --reboot or --no-reboot:
#cloud-config
write_files:
- path: /root/zopanel-release.pem
content: |
-----BEGIN PUBLIC KEY-----
MCowBQYDK2VwAyEAXitZpY6gmHkZfPC0eIgXnZSEP+tPpPa9fLeG8qffFPA=
-----END PUBLIC KEY-----
runcmd:
- |
set -e
cd /root
curl --proto =https --tlsv1.2 -fsSLO https://update.zopanel.net/install.sh
curl --proto =https --tlsv1.2 -fsSLO https://update.zopanel.net/install.sh.sig
base64 -d < install.sh.sig > install.sh.sig.bin
openssl pkeyutl -verify -pubin -inkey zopanel-release.pem -rawin -in install.sh -sigfile install.sh.sig.bin
ZOPANEL_LICENSE_KEY=ZP-XXXX-XXXX-XXXX bash install.sh --yes --reboot --admin-email admin@example.com
cloud-init already runs as root, so sudo is not needed. The generated admin password is printed in the installer output, which cloud-init writes to its log (usually /var/log/cloud-init-output.log). Reset it at any time with zopanel ctl reset-password admin.
When it finishes
The installer prints the address and the first login:
ZoPanel is ready!
URL: https://203.0.113.10:8888
Username: admin
Password: ••••••••••••••••
Save this password now — it is not stored anywhere in plain text.
The certificate is self-signed until you set a panel domain in Settings.
Before typing the password, check that your browser shows this certificate
fingerprint (SHA-256):
3A:9F:…:C2
or sign in through an SSH tunnel, which needs no certificate check:
ssh -L 8888:127.0.0.1:8888 root@203.0.113.10 then open https://127.0.0.1:8888
Before you type the admin password, make sure you are talking to your server and not to someone in between. Either open the certificate details in your browser's warning page and compare its SHA-256 fingerprint with the one the installer printed, or use the SSH tunnel shown (the connection then goes through SSH, which you already trust). Then sign in, set a panel domain under Settings → General → Panel domain & SSL so the panel gets a real certificate, and follow the Quick start.
If something goes wrong
- Run
zopanel ctl doctorto check the server and see how to fix what is wrong. - Lost the password:
zopanel ctl reset-password admin. - Locked out by the panel IP restriction:
zopanel ctl allow-ip --clear. - A failed step can be retried by running the installer again.