A node is a Debian 12 or 13 server (amd64 or arm64) that runs KVM. The panel never logs in to a node over SSH: each node runs the VMStack agent, which the panel reaches over mutual TLS on port 8443. You add the node in the panel, run the install command it shows on the server, and the panel enrols the node as soon as the agent answers.
Every node belongs to a location. Inside a location the panel places new servers on the node that fits best, within the capacity you allow each node to sell. Node groups let a billing product name an ordered list of nodes instead.
- Add a node: the install command and what happens next
- Installer options: every option of the node installer
- Enrolment and certificates: the token, the certificate and its renewal
- Agent updates on a node: channel, automatic updates, window
- Node firewall: rules that protect the node itself
- Node settings: network rules, KVM settings, capacity and caps
- Maintenance and unreachable nodes: no new servers, maintenance mode, emptying a node
- Locations, node groups and capacity
Hardware and network requirements for a node are in Node requirements.
- Add a nodeAdd a KVM node in the panel, run the install command it shows on the server, and check that the node is enrolled and ready for servers.
- Installer optionsEvery option of the VMStack node installer, install.sh, for a new install and for --upgrade: containers, ZFS, Ceph, storage setup, PBS, licensing and more.
- Enrolment and certificatesHow a node is enrolled with its one-time token, which certificate it gets, how the panel renews it before it expires, and how to enrol a node again.
- Agent updates on a nodeA node's agent version, update channel and window, turning automatic updates off, Update now, retrying a failed version, and upgrading by hand.
- Node firewallProtect the node itself: SSH allowlist, extra ports, ping, the agent port, and the automatic undo that keeps you from locking yourself out.
- Node settingsA node's tabs and its Settings tab: capacity, caps, dedicated CPUs, network rules, traffic, processor, disks, new servers and NAT.
- Maintenance and unreachable nodesStop new servers on a node, put it in maintenance mode, empty it onto other nodes before work, disable it, and what the panel does when a node stops answering.
- Locations, node groups and capacityGroup nodes into locations, choose how new servers are placed, build ordered node groups for billing products, and set how much of each node may be sold.