Open Source|All improvements go through Pull Requests with automated CI checks before review by@Leo-Galli|Join Discord|Contributing guide
Node management

Node management

Hypervisor nodes are the machines that host your servers.

Add a node

Admin → Nodes → Add Node, or via the API:

curl -sS http://127.0.0.1:8000/api/nodes \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "pve-01",
    "kind": "proxmox",
    "host": "10.0.0.10",
    "port": 8006,
    "credentials": {"token_id":"...", "token_secret":"..."}
  }'

Node kinds

KindAPIUse case
pterodactylWings + PanelGame servers, containers
proxmoxProxmox VE API v2VMs, LXC containers
virtfusionVirtFusion RESTVM lifecycle

Sync nodes

After adding credentials, click Synchronize nodes in the Admin Panel (or POST /api/nodes/sync). This pulls live telemetry, server counts and resource usage from the hypervisor.

Telemetry

curl -sS http://127.0.0.1:8000/api/nodes/{id}/telemetry \
  -H "Authorization: Bearer $TOKEN"

Returns CPU, memory, disk and network usage in real time.

See also: Pterodactyl bridge, Proxmox VE setup, VirtFusion setup.