list¶
See also: info, launch, snapshot, Availability zone
The multipass list command lists available instances. It presents a generic view of instances, with some of their properties, including the number of mounts each instance has and the availability zone it is in; for example:
Name State IPv4 Image Mounts Zone
primary Suspended -- Ubuntu 26.04 LTS 1 zone1
calm-squirrel Running 10.218.69.109 Ubuntu 26.04 LTS 0 zone2
If an instance’s zone has been disabled with multipass disable-zones, (n/a) is appended to its zone in the table output, and its state shows as Unavailable (see Instance states).
You can also use the --format option to get machine-readable output (CSV, JSON, or YAML), which also includes each instance’s mount count, zone name and availability.
Note
The json, csv and yaml formats cover regular output only. Errors and log messages are printed to the standard error stream as plain text, with failures signaled by a non-zero exit status.
For example, multipass list --format yaml:
primary:
- state: Suspended
zone:
name: zone1
available: true
ipv4:
- ""
release: 26.04 LTS
mounts: 1
calm-squirrel:
- state: Running
zone:
name: zone2
available: true
ipv4:
- 10.218.69.109
release: 26.04 LTS
mounts: 0
The full multipass help list output explains the available options:
Usage: multipass list [options]
List all instances which have been created.
Options:
-h, --help Displays help on commandline options
-v, --verbose Increase logging verbosity. Repeat the 'v' in the short
option for more detail. Maximum verbosity is obtained with
4 (or more) v's, i.e. -vvvv.
--format <format> Output list in the requested format.
Valid formats are: table (default), json, csv and yaml. The
json, csv and yaml formats cover regular output only.
Errors and log messages are printed to the standard error
stream as plain text, with failures signaled by a non-zero
exit status.