Multipass GUI client

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

See also: Instance, Service, Settings

The GUI was introduced in Multipass version 1.14. It is still in its MVP (Minimum Viable Product) stage, so it is likely to see some changes in design as it evolves.

The Multipass GUI (Graphical User Interface) is an application that acts as a client for interacting with the Multipass service. It aims to make the process of managing instances easier for users who do not want to interact with the CLI (Command Line Interface) client.
You can launch the GUI either using your system’s application launcher or by running multipass.gui in a terminal.

GUI features

As of now, the Multipass GUI provides the following set of capabilities, grouped under four tabs:

as well as a tray icon menu.

Catalogue tab

Here you can browse the available Ubuntu images. The output is equivalent to the one given by multipass find --only-images. Blueprints are not yet available.

Catalogue page

You can configure an instance’s launch options, specifying parameters such as its name, allocated resources and mounts.

Configure instance page

When you launch a VM, you can see details on all the steps taken and be notified of errors.

Launching page

Instances tab

Here you can see an overview of all your instances and perform bulk actions such as starting, stopping, suspending or deleting the selected ones. You can also filter instances by name and by state (“running” or “stopped”).

List of all instances page

You can perform actions on an individual instance, such as starting, stopping, suspending or deleting it. You can also open shells within a running instance, where you can do all of your work that is specific to that instance.

Instance shell page

You can also edit an instance; in particular, you can change its allocated resources, connect it to a bridged network or edit its mounts. Some of these settings require the instance to be stopped before they can be applied.

Edit instance page

Settings tab

Here you can change various Multipass settings, although not all settings that are available in the CLI are present in the GUI and vice versa.

Settings page

Tray icon

You can manage your instances using the tray icon menu as well.

Tray icon menu

GUI logs

The GUI produces its own logs, that can be found under ~/snap/multipass/current/data/multipass_gui/multipass_gui.log

The GUI produces its own logs, that can be found under ~/Library/Application\ Support/com.canonical.multipassGui/multipass_gui.log

The GUI produces its own logs, that can be found under %APPDATA%\com.canonical\Multipass GUI\multipass_gui.log

Last updated 5 days ago. Help improve this document in the forum.