`multipass suspend` command

The multipass suspend suspends instances specified as arguments. You can also pass the --all option to suspend all instances. Without arguments, the command will suspend the primary instance, if it exists. For example:

$ multipass suspend boisterous-tortoise
$ multipass ls
Name                    State             IPv4             Image
boisterous-tortoise     Suspended         --               Ubuntu 22.04 LTS

Only Running instances can be suspended. Suspended instances can be resumed with multipass start.


The full multipass help suspend output explains the available options:

$ multipass help suspend
Usage: multipass suspend [options] [<name> ...]
Suspend the named instances, if running. Exits with
return code 0 if successful.

Options:
  -h, --help     Display this help
  -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.
  --all          Suspend all instances

Arguments:
  name           Names of instances to suspend. If omitted, and without the
                 --all option, 'primary' will be assumed.

it would be great to mention how to resume a stopped instance, as there is no resume command.

Good point @dirkjot, thanks for the suggestion. Suspended instances can be resumed with the start command.

We should say this systematically for all commands that change the state of an instance. And we need to add a little to the documentation of this command in particular. I am adding tasks for us to do that later on.

1 Like