Koapanel
IT Try it free
All manual sections

DocumentationInstallation

Installation

Koapanel installs on a freshly created Ubuntu 24.04 server in a few minutes. The Free plan (up to 3 sites, personal use) works right away: no code needed.

Requirements

  • A fresh Ubuntu 24.04 LTS server (VPS or dedicated) with root access. Don't install it on a server already hosting sites or another panel.
  • At least 2 GB of RAM recommended: mail and antimalware adapt to the available memory.
  • Ports 80 and 443 reachable for websites and Let's Encrypt certificates; the panel uses port 8443.

1. Request the installer

The installer is made of two files: the panel program (panel-agent) and the install.sh script. During launch we send them on request: fill in the form and get the links by email.

By sending you agree that we use this data only to reply to you, as described in the privacy policy.

2. Run the installer

Copy both files to the server (for example with scp) and, as root, in the same folder:

$ chmod +x install.sh
$ sudo PANEL_BINARY=./panel-agent PANEL_LE_EMAIL=you@yourdomain.com ./install.sh

The script installs nginx, PHP-FPM, MariaDB, certbot, ufw, fail2ban, phpMyAdmin, the WordPress tools (WP-CLI, Redis) and ClamAV, then starts the panel as a service. It stops if it finds a panel already installed.

Useful options (environment variables):

  • PANEL_PHP=8.3 — initial PHP version (install others from the panel)
  • PANEL_PORT=8443 — panel HTTPS port
  • PANEL_MAIL=1 — also enable mail right away (can be done later from the panel)
  • PANEL_ADMIN_USER=admin — administrator username

3. First login

At the end the script shows only once the panel address (https://SERVER-IP:8443/), the administrator username and password: store them in a password manager. The initial certificate is self-signed: the browser warns about it the first time.

From there: create your first site, enable HTTPS, install WordPress. The manual is inside the panel too.

4. When you need more

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