Skip to main content

Your submission was sent successfully! Close

Thank you for signing up for our newsletter!
In these regular emails you will find the latest updates from Canonical and upcoming events where you can meet our team.Close

Thank you for contacting us. A member of our team will be in touch shortly. Close

`multipass snapshot` command

See also: restore, list, info, delete

The multipass snapshot command takes a snapshot of an instance; for example:

multipass snapshot maximal-stag

The output will be similar to the following:

…
Snapshot taken: maximal-stag.snapshot1

The snapshot will record all the information that is required to later restore the instance to the same state. For the time being, the snapshot command can only operate on instances in Stopped status.

You have the option to specify a snapshot name using the --name option, following the same format as the instance name format. If you don’t specify a name, the snapshot will be named “snapshotN”, where N is the total number of snapshots that were ever taken of that instance. You can also add an optional comment with --comment. Both of these properties can be later modified with the set command, via the snapshot settings keys documented in Settings.


The full multipass help snapshot output explains the available options:

Usage: multipass snapshot [options] instance
Take a snapshot of an instance that can later be restored to recover the current state.

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.
  -n, --name <name>            An optional name for the snapshot, subject to
                               the same validity rules as instance names (see
                               `help launch`). Default: "snapshotN", where N is
                               one plus the number of snapshots that were ever
                               taken for <instance>.
  --comment, -c, -m <comment>  An optional free comment to associate with the
                               snapshot. (Hint: quote the text to avoid spaces
                               being parsed by your shell)

Arguments:
  instance                     The instance to take a snapshot of.

Errors or typos? Topics missing? Hard to read? Let us know or open an issue on GitHub.

Last updated 2 months ago. Help improve this document in the forum.