Platform Administration

Manage Hosts

Monitor compute nodes across all zones.

Hosts are the individual Proxmox nodes that make up your zones. Each host runs the flexplane-agent, which connects it to the mesh network and acts as an authenticating proxy for the Proxmox API. The hosts view gives you visibility into node health, resource utilization, and agent status.

View all hosts

Navigate to Platform > Hosts in the portal. The hosts page lists every node across all zones with their status, resource usage, and agent version.

The Hosts page displays all nodes with their status, zone, CPU/memory usage, uptime, and agent version.

FieldDescription
statusWhether the host is reachable (online / offline).
uptimeHow long the host has been running since last boot.
zoneThe zone (Proxmox cluster) this host belongs to.
cpuNumber of logical CPU cores.
cpuUsageCurrent CPU utilization as a percentage.
memoryTotal memory.
memoryUsageCurrent memory usage.

Check agent status

Every host runs the flexplane-agent. The agent field tells you:

  • version: The currently installed agent version.
  • updateAvailable: Whether a newer version is available.
  • availableVersions: The list of versions you can update to.

If a host shows no agent information (the field is null), the agent is either not installed or not connected to the mesh network. Check that:

  1. The agent service is running on the node: systemctl status flexplane-agent
  2. The node has joined the Tailscale/Headscale mesh.
  3. The node is reachable from the management cluster.
A host can appear in the zone's host list (discovered via Proxmox) but have no agent info if the agent has not been installed yet. See Register a Node for the installation process.

View host details

Click on a host in the list to see its full details, including resource usage, agent version, and the audit log of all operations that ran on it.

If a host shows high CPU or memory usage but few VMs are running, check for Proxmox-level processes (ZFS scrubs, backup jobs, replication) that may be consuming resources outside flex.plane's visibility.