How to set up the driver

See also: Driver, local.driver

This document demonstrates how to choose, set up, and manage the drivers behind Multipass. Multipass already has sensible defaults, so this is an optional step.

Default driver

By default, Multipass on Linux uses the qemu driver.

By default, Multipass on macOS uses the qemu driver.

By default, Multipass on Windows uses the hcs driver.

Install an alternative driver

On Linux, only the qemu driver is supported, so switching local.driver is not possible.

An alternative option is to use the Apple Virtualization framework.

To switch the Multipass driver to the Apple Virtualization framework, run this command:

multipass set local.driver=applevz

From now on, all instances started with multipass launch will use the Apple Virtualization framework behind the scenes.

You can change the hypervisor that Multipass uses to Hyper-V.

Note

The Hyper-V driver is deprecated as of Multipass version 1.17 (see Migrate from Hyper-V to the HCS driver on Windows).

To switch the Multipass driver to Hyper-V, run this command:

multipass set local.driver=hyperv

From then on, all instances started with multipass launch will use Hyper-V behind the scenes.

Switch back to the default driver

See also: stop, local.driver

On Linux, there is only one driver and changing it is not possible.

If you want to switch back to the default driver, run:

multipass set local.driver=qemu

Instances are tied to the driver they were created with; after switching, they won’t be visible until you switch back.

If you want to switch back to the default driver:

multipass set local.driver=hcs

Instances are tied to the driver they were created with; after switching, they won’t be visible until you switch back.