Reset Command

The reset command resets Talos node(s) to their initial state, wiping system partitions and rebooting.

Nodes already in maintenance mode are automatically skipped.

Flags

All flags can also be set via environment variables using the TOPF_ prefix and uppercasing the flag name (e.g. --wait-for-maintenance → TOPF_WAIT_FOR_MAINTENANCE).

Flag	Default	Description
--full	true	Wipe the entire disk. If false, only STATE and EPHEMERAL partitions are wiped
--graceful	false	Attempt to cordon/drain the node and leave etcd before resetting
--shutdown	false	Shut down the machine after reset instead of rebooting
--wait-for-maintenance	false	Wait for all reset nodes to reach maintenance mode before returning
--nodes-filter	-	Regex pattern to filter which nodes to operate on (global flag)

Example Usage

# Reset with full disk wipe (default)
topf reset

# Reset only STATE and EPHEMERAL partitions
topf reset --full=false

# Graceful reset (drain workloads first)
topf reset --graceful

# Reset and shut down instead of rebooting
topf reset --shutdown

# Reset specific nodes
topf reset --nodes-filter "node[1-2]"

# Reset and wait for nodes to enter maintenance mode (useful for chaining with apply)
topf reset --wait-for-maintenance