NAME

puter-node - manage cluster nodes

SYNOPSIS

puter node list

DESCRIPTION

Manage nodes in a puter cluster. Currently supports listing nodes and their status.

The list subcommand displays all cluster nodes with their role, status, VM count, subnet, and WireGuard IP.

Output columns:

NAME

The node's hostname.

ID

Numeric node identifier.

ROLE

Either "leader" or "worker".

STATUS

Node status: online or offline.

VMS

Number of VMs running on this node.

SUBNET

The node's assigned VM subnet (e.g., 10.0.0.0/24).

WG IP

The node's WireGuard overlay IP (e.g., 10.99.0.1).

EXAMPLES

$ puter node list
NAME     ID  ROLE    STATUS  VMS  SUBNET        WG IP
leader   0   leader  online  3    10.0.0.0/24   10.99.0.1
worker1  1   worker  online  2    10.0.1.0/24   10.99.0.2

SEE ALSO

puter-migrate(1), puter-start(1)