Skip to content

Nodes Command

The nodes command lists all nodes and their current state.

Flags

Flag Default Description
--output, -o table Output format: table or yaml
--nodes-filter - Regex pattern to filter which nodes to operate on (global flag)

Table Output

The default table output displays the following columns:

Column Description
Host Node hostname
IP Node IP address
Role control-plane or worker
Stage Current machine stage
Ready or
Unmet Conditions Conditions preventing readiness
Schematic Installer schematic (truncated)
Talos Installed Talos version
Error Any error encountered

Example Usage

# List nodes in table format
topf nodes

# List nodes in YAML format
topf nodes -o yaml

Tip

To generate machine configs without a running cluster, use the render command. Use render --online to generate configs using the actual running Talos version.