`multipass find` command

The multipass find command without any argument will list the aliases you can use to launch instances with multipass launch on your system and associated version information, e.g.:

$ multipass find
multipass launch …   Starts an instance of           Image version
------------------------------------------------------------------
[...]
18.04                Ubuntu 18.04 LTS                20181003
   (or: b, bionic, default, lts)
daily:18.10          Ubuntu 18.10                    20181011
   (or: c, cosmic, devel)

The full multipass help find output explains the available options:

$ multipass help find
Usage: multipass find [options] [<remote:>][<string>]
Lists available images matching <string> for creating instances from.
With no search string, lists all aliases for supported Ubuntu releases.

Options:
  -h, --help     Display this help
  -v, --verbose  Increase logging verbosity, repeat up to three times for more
                 detail

Arguments:
  string         An optional value to search for in [<remote:>]<string> format,
                 where <remote> can be either ‘release’ or ‘daily’. If <remote>
                 is omitted, it will search ‘release‘ first, and if no matches
                 are found, it will then search ‘daily‘. <string> can be a
                 partial image hash or an Ubuntu release version, codename or
                 alias.

You can pass an argument in the form [<remote>:], limiting the output to just that remote:

$ multipass find daily:
multipass launch …   Starts an instance of           Image version
------------------------------------------------------------------
[...]
daily:18.04          Ubuntu 18.04 LTS                20181011
   (or: b, bionic, default, lts)
daily:18.10          Ubuntu 18.10                    20181011
   (or: c, cosmic, devel)

The supported values for <remote> are:

You can also ask for a specific alias:

$ multipass find default
multipass launch …   Starts an instance of           Image version
------------------------------------------------------------------
default              Ubuntu 18.04 LTS                20181003

A set of examples for the <alias> value:

  • default - the default image on that remote,
  • lts - the latest Long Term Support image,
  • devel - the latest development series image (only on daily:),
  • <codename> - the code name of a Ubuntu series,
  • <c> - the first letter of the code name,
  • <XX.YY> - the version number of a series.

This is not an exhaustive list, there may be new ones introduced and not all of them may be supported on your system.


Last updated 2 years ago.