list¶
See also: info, launch, snapshot, Availability zone
The multipass list command lists available instances or snapshots. With no options, it presents a generic view of instances, with some of their properties, including the availability zone each instance is in; for example:
Name State IPv4 Release Zone
primary Suspended -- Ubuntu 26.04 LTS zone1
calm-squirrel Running 10.218.69.109 Ubuntu 26.04 LTS 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 call it with the --snapshots flag to get an overview of available snapshots. Here’s a sample output of multipass list --snapshots:
Instance Snapshot Parent Comment
calm-squirrel snapshot1 -- --
calm-squirrel snapshot3 snapshot1 Before restoring snapshot2
The multipass list command will truncate long snapshot comments, as well as those containing newlines. You can use info to view them in full.
You can also use the --format option to get machine-readable output (CSV, JSON, or YAML), which also includes each instance’s zone name and availability. For example, multipass list --format yaml:
primary:
- state: Suspended
zone:
name: zone1
available: true
ipv4:
- ""
release: 26.04 LTS
calm-squirrel:
- state: Running
zone:
name: zone2
available: true
ipv4:
- 10.218.69.109
release: 26.04 LTS
The full multipass help list output explains the available options:
Usage: multipass list [options]
List all instances or snapshots 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.
--snapshots List all available snapshots
--format <format> Output list in the requested format.
Valid formats are: table (default), json, csv and yaml