See also: How to manage instances
An instance is a virtual machine created and managed by Multipass.
A valid instance name must conform to a specific format. It can only include alphabetic letters, numbers, or hyphens. The initial character must be an alphabetic letter, while the final character must be alphanumeric.
The Multipass CLI provides a few shortcuts using one special instance, which is distinguished by name: the primary instance. By default, this is the instance named
When invoked without positional arguments, state transition commands —
suspend — operate on this special instance. So does the
shell command. Furthermore,
shell create the primary instance if it does not yet exist.
When creating the primary instance, the Multipass CLI client mounts the user’s home directory automatically into it.
As with any other mount, it can be unmounted with
multipass umount. For instance,
multipass umount primary will unmount all mounts made by Multipass inside
primary, including the auto-mounted
Home. (On Windows, mounts are disabled by default for security reasons. See
local.privileged-mounts for information on how to enable them if you need.)
In all other respects, the primary instance is the same as any other instance. Its properties are the same as if it had been launched manually with
multipass launch --name primary.
The name of the instance that the Multipass CLI treats as primary can be modified with the setting
client.primary-name. This setting determines the name of the instance that Multipass creates and operates as primary, providing a mechanism to turn any existing instance into the primary instance, as well as disabling the primary feature.
Last updated 24 days ago.