KoaVM
Guide

The KoaVM guide.

How to install and use KoaVM, page by page. It's the same guide you find in the panel under Guide, and it always follows the latest version.

For administrators

  1. IntroductionKoaVM is the panel to sell and manage VPSs, built on Incus. One program does everything: API, interface for you and…
  2. InstallationWith --domain the panel requests its HTTPS certificate from Let's Encrypt on its own: the name must already point to…
  3. NodesA node is a server with Incus. VPSs are created on the node with the most assignable RAM left (with its overbooking,…
  4. Network and IPsNetwork & IPs holds the address blocks the panel gives to VPSs. Each square is an IPv4 address: filled when free, grey…
  5. Plans and operating systemsIn Clients & plans › Plans you decide what you sell. Changing a plan does not touch existing VPSs: to move them to the…
  6. Customers and VPSsIn Clients & plans › Clients you create customers (name, company, email). For a new customer the panel generates a…
  7. Backups and snapshotsSnapshots and backups also include the VPS's extra disks. Before starting, the panel asks the VPS (through the agent)…
  8. Provider VPSsBesides the VPSs on your nodes you can resell Hetzner Cloud, Contabo and Scaleway Instances VPSs under your brand.…
  9. Migration from other panelsKoaVM moves VMs from other panels to the KoaVM nodes keeping the same IP and MAC, cold or near-live (about 10 seconds…
  10. API and integrationsIn Settings › API › Create key name the key (e.g. "WHMCS"). The key, kvm…, is shown only once: copy it right away. Each…
  11. Settings and securityIn Settings choose the name shown to customers (the customer area shows your name, not KoaVM) and the support email: it…
  12. Updates and versionsThe What's new page lists every version with its date and what changes, for you and for your customers. The same list…
  13. Private networksEvery customer can have private networks: their VPSs talk to each other on private addresses (e.g. 10.10.0.0/24), even…
  14. Moving between nodesA VPS moves to another node from its page: Administration › Move to another node. The panel runs the checks first (room…
  15. AlertsAn open alert isn't repeated until the problem goes away; then the alert closes and, for nodes and VPSs, a "fine again"…
  16. ResellersA reseller is a customer with their own customers, who creates their VPSs from the panel or from their own WHMCS, with…
  17. New nodes and automatic purchasingSince 0.9 the panel sets up nodes on its own. It starts from a server you already have or from one it orders for you…
  18. Systems, templates, ISOs and appsSince 0.10 the VPS systems have their own page: Systems. It has four tabs: the systems you offer, the KoaVM catalogue,…
  19. Firewall, volumes and floating IPsSince 0.11 every VPS has its own firewall, extra disks become volumes that you can detach and attach to another VPS,…
  20. Self-service and hourly usageSince 0.12, besides plan VPSs, you can sell a package of resources: the customer creates, resizes and deletes their own…
  21. Load balancersSince 0.14 the panel creates managed load balancers: a public address that receives traffic and splits it between a…
  22. Routers and VPSs without public IPv4Since 0.15 a VPS can be created without a public IPv4: it only has the customer's private network (and IPv6, if the…
  23. DNSSince 0.16 the panel has managed DNS: customers put their domains' zones here and change them on their own, as they…
  24. LicenseKoaVM is paid per node: the Incus servers the VPSs run on. On licensed nodes VPSs are unlimited. Prices and the…
  25. Two-step verificationWith two-step verification, your password is not enough to sign in to the panel: you also need a 6-digit code that…
  26. High availabilityIf a node suddenly goes down (hardware fault, frozen kernel, power), its VPSs stay down until the node comes back. With…
  27. GPUGPUs are never overcommitted: a slice of a card belongs to one VPS only.
  28. Clusters and shared storageIn Incus shared storage works only inside a cluster: a Ceph pool is not shared between independent Incus servers.

For customers

For your customers: these are the pages they see in their area.

  1. Your VPSThe Services page lists your VPSs. Open one to see status, resources, charts and all the commands.
  2. Snapshots and backupsHow many snapshots and backups you can keep depends on your plan: you see it next to the title of each box (e.g. "1/2").
  3. Network, traffic and accountThe VPS Network box shows the IPv4 address, gateway, DNS and, if your plan includes it, the IPv6 address (with gateway…
  4. Private networks and resellersIn Private networks you create a network of your own between your VPSs, even in different datacenters: traffic is…
  5. Firewall, volumes and IPsThe Add buttons insert the most common rules (SSH, Web, Remote desktop, Ping, Email, DNS). Click Save rules: they apply…
  6. Create your VPSsIf your service includes a self-service package, in Services you find the "Your package" box: how many VPSs, vCPUs, RAM…
  7. Team and APIOn the Team & API page you invite the people who work with you on your servers, create API keys for your scripts and…
  8. Load balancersA load balancer receives traffic on a public address and splits it between your VPSs, checking that they answer: if a…
  9. Routers and VPSs without public IPv4A VPS without a public IPv4 sits only on your private network: it can't be seen from the internet, but it reaches the…
  10. DNSOn the DNS page you put your domains on the panel's nameservers and manage their records: where the website points,…
  11. Two-step verificationWith two-step verification, your password is not enough to sign in to the client area: you also need a 6-digit code…
  12. Protected VPS (high availability)If your VPS is protected, its page shows the High availability box (and the services list says "High availability:…
Latest version · 1.18.0Clusters and shared storage17 October 2026 · Everything new →