NAME

puter-list - list VMs

SYNOPSIS

puter list [--node name] [-v|--verbose]

DESCRIPTION

List all VMs managed by puter. Displays each VM's name, node, status, and IP address in a table format.

When any VM is in "error" status, an ERROR column is shown with truncated error messages (60 characters max). Use --verbose to show full error messages.

Status values are color-coded when output is a terminal: running (green), error (red), stopped (dim), creating, starting, stopping (yellow). Colors are automatically suppressed when output is piped or redirected to a file.

OPTIONS

--node name

Filter VMs by cluster node name (e.g., "node-1", "local").

-v, --verbose

Show full error messages without truncation.

Output columns:

NAME

The VM name.

NODE

The cluster node the VM runs on, or "local" for single-host mode.

STATUS

Current VM status: running, stopped, error, creating, starting, or stopping.

IP

The VM's assigned IP address.

ERROR

Error message for VMs in error status (only shown when at least one VM has an error).

EXAMPLES

$ puter list
NAME   NODE   STATUS   IP
myvm   local  running  10.0.0.10
web    local  stopped  -

With a VM in error state:

$ puter list
NAME    NODE   STATUS   IP   ERROR
myvm    local  running  10.0.0.10
badvm   local  error    -    image "nonexistent:latest" not found...

SEE ALSO

puter-info(1), puter-start(1), puter-stop(1)