Guide · For administrators
License
KoaVM is paid per node: the Incus servers the VPSs run on. On licensed nodes VPSs are unlimited. Prices and the founders offer are on koavm.com/en/pricing.
Free trial
Without a license the panel has every feature, migration included, with 1 node and up to 5 VPSs for 30 days from installation (load balancer and router machines don't count; provider VPSs do). Beyond the limit the panel doesn't add nodes or VPSs, and says so in the message and on the License page, which also shows how many days are left.
One week before the end you get an alert and a strip appears at the top of the pages. Once the trial has ended the panel no longer creates nodes or VPSs (not even from migration, self-service or WHMCS and KoaBilling) until you add a license. Existing VPSs keep running and are managed as before: power, backups, snapshots, reinstalls, moves between nodes.
Adding a key
- Buy the license (or ask your reseller): you get a key like
KVM-XXXXX-XXXXX-XXXXX-XXXXX. - In the panel: License › Add a key. The key is checked right away with the license server.
- You can have several keys: their nodes add up. The Provider VPSs license (pay per use) is needed to create VPSs on Hetzner Cloud, Contabo and Scaleway from the panel; on its own it leaves the trial limits on the nodes.
A key works on one panel at a time. To move it to another panel remove it here (License › Remove the key): the server releases it right away. After a move the key can't move again for 14 days (going back to the previous panel is fine). If the old panel is gone, after 15 days without news the key moves to the new one by itself; before that, support can do it.
The panel ID depends on the database and on the server: if you move the panel to another server, remove the keys first and add them again afterwards (or ask support to release them).
How it is checked
- The panel asks the license server (
koavm.com/api/license) for a signed answer one minute after starting and then every 12 hours. It sends the keys, the panel ID, its address, its version and how many nodes and VPSs it has (for provider VPSs, which are paid per use). No customer data. - The answer is valid for 14 days: if the license server doesn't answer, the panel keeps working and sends an alert after 3 days. After the 14 days the trial limits apply to new nodes and VPSs.
- If a license is suspended (renewal not paid), cancelled, expired or smaller than the connected nodes, the panel doesn't add nodes or VPSs. Customer VPSs are never shut down because of the license: they keep running and are managed as usual (power, backups, reinstalls, moves…).
- Alerts (if you have a channel in Alerts): trial ending within a week, trial ended, license server unreachable, license not active, more nodes than the license covers.
- If the keys are no longer active and the 30 trial days have passed, the ended-trial rules apply: no new nodes or VPSs, VPSs keep running.
What counts
| What | Counts as |
|---|---|
| Connected Incus node | 1 node (also when off or in maintenance) |
| Node being set up or ordered by the panel | 1 node (the slot is held while the setup goes on) |
| Provider zone (Hetzner Cloud, Contabo, Scaleway) | no node: VPSs there are paid with the «Provider VPSs» license |
| VPS, also migrated or self-service | 1 VPS on the trial (30 days); unlimited with a license |
| Load balancer or router machine | nothing |