Installation

$ curl -fsSL https://get.koapanel.app | sudo bash

The script checks the system, downloads the panel from the official channel and verifies its digital signature (ed25519) and SHA-256 checksum before installing. If anything doesn't match, it stops without touching the server.

Options: KOAPANEL_EMAIL=you@domain.com (Let's Encrypt email), KOAPANEL_MAIL=1 (enable mail right away), KOAPANEL_DOWNLOAD_ONLY=1 (download and verify only). Example: curl -fsSL https://get.koapanel.app | sudo KOAPANEL_EMAIL=you@domain.com bash

With parameters you choose everything from the command: curl -fsSL https://get.koapanel.app | sudo bash -s -- --hostname panel.mydomain.com --email you@mydomain.com --license CODE --koabilling. --hostname is the name of the panel: the Let's Encrypt certificate arrives by itself if the name already points to the server and port 80 is open. --license activates the license. --koabilling shows at the end the address and the API key to paste in KoaBilling; without a license, the key works once the account is linked.

Prefer to read the script first? Download it, review it, then run sudo bash install.sh.

Requirements

• A fresh server (VPS or dedicated) running Ubuntu 24.04 o 26.04 LTS, AlmaLinux 9 or Rocky Linux 9 (SELinux can stay enforcing), x86_64 or arm64, with root access. Don't install it on a server already hosting sites or another panel: the script detects it and stops.
• At least 2 GB of RAM recommended: mail and antivirus adapt to the available memory.
• Ports 80 and 443 reachable for websites and certificates; the panel uses port 8443. The firewall is configured for you.

What it installs

nginx, PHP-FPM 8.3 (other versions from the panel), MariaDB with phpMyAdmin, certbot, the firewall (ufw on Ubuntu, firewalld on AlmaLinux and Rocky) and fail2ban, the WordPress tools (WP-CLI, Redis), the ClamAV antivirus, the system's automatic security updates and the KoaPanel panel as a service. Mail is optional and can be enabled from the panel whenever you want.

2. First login

At the end the script shows the panel address (https://SERVER-IP:8443/), the administrator username and password, also saved in /root/koapanel-install.log (readable by root only): copy them into a password manager, then delete the file. During the installation the panel asks Let's Encrypt for a valid certificate for the IP address too, so the browser normally shows no warning; if ports 80 and 443 are closed the self-signed certificate stays for now and the browser warns about it.

From there: create your first site, enable HTTPS, install WordPress. The manual is inside the panel too, and updates arrive from the Updates page.

3. Create your free account

In the customer area press Sign in with Prime Software ID and choose "First access": you get a link by email, choose a password and you're in. Then press Activate the free plan, copy the license key and paste it in the panel under Plan and license.

The customer area also has your support requests, orders with invoices and, for paid licenses, moving to another server and managing the subscription. Each account has one Free plan, for one server.

4. When you need more

For more than 3 sites or business use pick a plan: in the panel open Plan and license, press Upgrade to…, complete the purchase and the code activates in one click. No reinstall needed.

Need a hand?

If the installation fails or you'd like our help, write to us: attach the last lines of /root/koapanel-install.log (without the password).