All manual sections
- Installation
- Getting started
- Sites
- HTTPS
- Databases
- Files and SFTP
- Backup and restore
- Scheduled tasks (cron)
- Security
- System emails
- Updates
- Accounts and roles
- Packages
- Resellers
- Sign in as and suspension
- Plan and license
- Linked servers
- PHP versions
- Language
- License and activation
- Support
- WordPress
- DNS and providers
- Code editor
- Antimalware
- Migration from cPanel and Plesk
- Migration over SSH
- Disks
- This server's DNS
- Real-time protection
- AI assistant
- Server resources
- KoaPanel account
- WHMCS and API keys
- API and webhooks
- Privacy and error reports
- All servers and quick search
- Web terminal
- Isolation & limits
- Panel certificate
- Install apps
- Apache/.htaccess compatibility
- PostgreSQL
- Node.js and Python applications
- Passkeys and secure sign-in
- Notifications on Slack, Discord and Telegram
- Moving an account to another server
- .NET applications (ASP.NET Core)
- Site builder
- Migration from a WordPress site
- Site rules
- Logs and statistics
- Application firewall
- Savings
- Team
- Services
- Check, resume and cutover
Documentation
The complete KoaPanel manual: the same one you find inside the panel, in the Manual section.
Installation
Requirements, install on Ubuntu 24.04 or 26.04, AlmaLinux 9 or Rocky Linux 9 and first login.
Getting started
The panel lets you manage your web server from the browser: publish sites, turn on HTTPS, create databases, upload files and make backups, w…
Sites
Every site has its own space on the server, separated from the others: a problem on one site (for example a vulnerable plugin) cannot touch …
HTTPS
HTTPS protects the data visitors exchange with your site and shows the padlock in the browser. The panel uses free Let's Encrypt certificate…
Databases
Many sites (WordPress, online shops, business applications) store their data in a database. The panel creates MariaDB databases, compatible …
Files and SFTP
You can manage the site files in two ways: from the browser with the file manager or with a program such as FileZilla or Cyberduck via SFTP.…
Backup and restore
A backup is a safety copy of the site. The panel saves the site files, the linked databases, the mail of its domains' mailboxes and the site…
Scheduled tasks (cron)
Some sites need to run an operation at regular intervals: send newsletters, clear the cache, update data, back up the database. These operat…
Security
The Security page is divided into tabs: Firewall (with ports, addresses, automatic defences, check and register), Access (fail2ban and manda…
System emails
The panel can send emails to warn you when something is wrong and to tell you the news of every update. The System emails page is reserved f…
Updates
The panel improves over time: every new version brings new features, improvements and fixes. The server operating system (Ubuntu, AlmaLinux …
Accounts and roles
The panel has three levels, like the big hosting panels.…
Packages
A package sets the limits of an account:…
Resellers
A reseller is, for example, a web agency reselling hosting to its customers.…
Sign in as and suspension
To help the user of an account you can see the panel exactly as they see it:…
Plan and license
The panel is free for personal use up to 3 sites. To host more sites, or for work, you need a license of a higher plan. Administrators find …
Linked servers
If you manage several servers with the panel you can link them together: you see them in the menu under the logo and move from one to anothe…
PHP versions
Several PHP versions can live on the same server, from 7.4 to 8.5: every site uses its own. The PHP versions page is reserved for administra…
Language
The panel is available in Italian, English and French (since 0.53). Whoever opens the panel for the first time sees it in their browser lang…
License and activation
Since version 0.9 the license, besides being verified on the server, is activated online on the license server. It serves one purpose only: …
Support
Panel administrators can write to us directly from the Support section: open a request, attach files, follow the answers and reply.…
WordPress
The WordPress section gathers everything a fast and safe WordPress site needs: one-click installation, three cache levels, safe updates with…
DNS and providers
The panel can manage the DNS of your domains when it is at Cloudflare or 1PrimeCDN: you see the records, edit them, and point a site to this…
Code editor
The file manager has a full code editor, made for touching up PHP, HTML, CSS, JavaScript and configuration files without downloading them.…
Antimalware
The Antimalware section scans your sites' files for malware, web shells and modified WordPress files. It is in the menu for administrators, …
Migration from cPanel and Plesk
The Migration section brings a whole cPanel or Plesk account onto this server starting from its backup file, with no need to reach the old s…
Migration over SSH
With Migration › From a server over SSH the panel connects straight to the old server, recognizes what is there (cPanel, Plesk, CWP, DirectA…
The panel includes an optional mail service: mailboxes on your sites' domains, forwarders, autoresponder, antispam, DKIM signing and a webma…
Disks
In Server › Disks (administrators only) you see the server's disks: size, type (SSD, NVMe, virtual disk), the partitions with their filesyst…
This server's DNS
Like cPanel, the server can be the authoritative DNS of the domains it hosts: no external provider, the records are ready and update by them…
Real-time protection
Real-time protection checks the files of the sites as they are written: a vulnerable plugin used to upload a web shell, a file changed over …
AI assistant
The AI assistant diagnoses a site with an artificial intelligence model (Anthropic's Claude): it reads the site's logs, configuration and re…
Server resources
The Server › Resources page shows the server's plan at the provider (CPU, memory, disk, monthly cost) and lets you move to a bigger plan whe…
KoaPanel account
The panel can be connected to your KoaPanel account, the customer area at console.koapanel.app/account (sign-in with Prime Software ID). Con…
WHMCS and API keys
KoaPanel connects to WHMCS (8.x and 9.x) with the official module: when a customer orders hosting, WHMCS creates the account on the panel, s…
API and webhooks
Every KoaPanel server has a public REST API for billing systems and integrations other than WHMCS: accounts, resellers, packages, sites, dat…
Privacy and error reports
If something breaks, the panel can tell KoaPanel by itself, without you opening a support request. The choice is in Privacy (administrators …
All servers and quick search
If you linked other KoaPanel servers (Linked servers), the All servers page shows the sites of this panel and of every linked server in one …
Web terminal
Administrators can open a server shell in the browser, without an SSH client.…
Isolation & limits
Isolation & limits is an optional module that does what CloudLinux does on other panels: every account has CPU, memory, process, disk and da…
Panel certificate
The panel, phpMyAdmin and webmail open over HTTPS. From version 0.30.0 the panel asks Let's Encrypt by itself for a valid certificate also w…
Install apps
On every site page, the Applications tab installs a ready-made application in one click: the panel downloads the official package, checks it…
Apache/.htaccess compatibility
The panel serves the sites with nginx: fast, with the certificate, the page cache and the protections. nginx does not read .htaccess files: …
PostgreSQL
Next to MySQL/MariaDB the panel also manages PostgreSQL, for the applications that need it (many Python and Node.js applications, Odoo, Mast…
Node.js and Python applications
A site can be a Node.js or Python application instead of PHP: Express, Next.js, NestJS, Django, Flask, FastAPI and the like. It is set up on…
Passkeys and secure sign-in
On the Account page, Secure sign-in box, every user (administrator, reseller or user) can protect their sign-in with passkeys, an authentica…
Notifications on Slack, Discord and Telegram
Administrators receive the important alerts of the server right in their chat: Slack, Discord or Telegram. They are set up where webhooks ar…
Moving an account to another server
An account moves, with everything it has, to another server managed by the panel and linked in Linked servers: sites with their files, Maria…
.NET applications (ASP.NET Core)
A site can be an ASP.NET Core application (.NET 8 or .NET 10, the LTS versions): APIs, MVC sites, Razor Pages, Blazor Server. It is set up o…
Site builder
The Builder creates a website without writing code, with artificial intelligence at its centre: you describe the site in a chat and it build…
Migration from a WordPress site
With Migration › From a WordPress site you bring onto this server a WordPress site from any host (SiteGround, Hostinger, Bluehost, GoDaddy, …
Site rules
On the site page, Rules tab, you set what cPanel has under Redirects, Directory Privacy, IP Blocker, Hotlink Protection, Error Pages and MIM…
Logs and statistics
On the site page you find two tabs: Statistics, with the visits and the traffic computed from the web server logs (like AWStats in cPanel), …
Application firewall
The application firewall (WAF) checks every request to the sites with ModSecurity and the OWASP Core Rule Set, the rules cPanel uses too, an…
Savings
In Server › Savings you see how much RAM the server really uses, and you turn on, one by one or all together with Turn all on, the optimizat…
Team
With the Team (like cPanel's Team Manager) you give collaborators access to the panel, for example a web agency, a developer or whoever hand…
Services
In Server › Services you see the services the panel manages on this server and their state, and you can restart, start or stop them one by o…
Check, resume and cutover
From 0.83 every migration, from a backup file or over SSH, ends with a check of the sites and is completed with a single button. If it stops…