Skip to content

Multipass

Canonical Ltd. · Canonical’s CLI and GUI for local Ubuntu virtual machines, with cloud-init setup, resource controls and host-file sharing on Mac.

CaskVirtualization & Containers 9.4K
Install command
brew install --cask multipass
30-day installs
3,098
#112 in App
1-year installs
24.3K
Last 365 days
Latest version
1.17.2
Download size
163MB
pkg
Release cadence
Weekly
3 releases in 30 days

About

Multipass is Canonical's tool for launching and managing local Ubuntu virtual machines on macOS, Windows and Linux. It provides a command-line client and a graphical client for creating development environments without repartitioning your computer or replacing its operating system. An instance is a full virtual machine, not merely a container or a remote cloud account.

Features

  • Find available Ubuntu images and launch named instances.
  • Choose virtual CPU, memory and disk allocations for each environment.
  • Open an Ubuntu shell or execute commands inside an instance.
  • Use cloud-init to configure reproducible development and test environments.
  • Inspect, start, stop and suspend instances through the CLI or GUI.
  • Transfer files or mount selected host directories into a guest.
  • Use supported snapshots and clones when the chosen backend permits them.

Install and first use

Install this Mac cask with brew install --cask multipass, or run Canonical's official Mac PKG installer. Installation requires an administrator account and installs the background Multipass service as well as clients. Review operating-system prompts for the installer and service rather than assuming this is only a portable app.

After installation, multipass find lists available images. A typical first instance can be created with multipass launch --name dev, inspected with multipass list and accessed with multipass shell dev. These are user instructions: launching an instance downloads an image when needed, consumes local resources and creates VM storage. Use multipass stop dev when it is not needed, and inspect the instance before deleting or purging it.

Choose resource allocations appropriate to your guest workload while leaving enough memory and CPU capacity for macOS. Cloud-init configurations can install packages or run commands inside the guest; use configurations from sources you trust. Treat shared host folders as explicit access granted to the VM. Mount only the data the guest needs, and back up important files before destructive guest operations or permanent instance removal.

Mac virtualization and networking

Canonical documents QEMU, using Apple's Hypervisor framework, as the default Mac backend. Intel and M-series Macs running macOS 10.15 Catalina or later are supported by the captured installation guide. The Mac package handles the appropriate architecture; guest images and backend capabilities still need to match the host. VirtualBox is an alternative backend where supported and must be installed/configured separately; it is not required for the default QEMU route. Windows Hyper-V and Linux LXD behavior are platform-specific, not Mac prerequisites.

Instances have virtual networking and can make outbound connections. Bridged networking and host-folder mounts require deliberate configuration and may expose additional access; review network choices and service authentication for your environment. Multipass is not a VPN or a security boundary that makes arbitrary untrusted workloads safe. The privileged daemon, its authentication and guest/host file sharing deserve the same care as other virtualization software.

Multipass does not require Docker Desktop or a paid cloud account to run local Ubuntu VMs. Docker or other development tools can be installed inside a suitable guest when needed; that is a separate installation. Running multiple virtualization tools can compete for memory, disk and network resources even when there is no declared cask conflict.

Requirements and downloads

This cask installs the Mac distribution; Windows and Linux have separate installers. The current 1.16.4 Mac PKG is 152,440,298 bytes according to the official GitHub release asset and installer HTTP metadata. Installer size excludes Ubuntu images, virtual disks, snapshots and your project data. No single host RAM or installed-space minimum is asserted for all workloads. Allow additional storage and memory for each VM and network access for initial image downloads and updates.

Keep Multipass itself and the guest operating system updated separately. A new Multipass release does not automatically promise every existing Ubuntu instance has installed its own security updates. The 1.16.3 release specifically fixes Mac M4 QEMU compatibility; the 1.16.2 release fixes a macOS Tahoe 26 vmnet subnet collision. Prefer current supported releases when using affected systems.

Price and license

Multipass is free, open-source software from Canonical under GPL version 3, with third-party components retaining their own notices and licenses. No purchase, subscription or mandatory online account is needed for basic local VM management. Optional Ubuntu support, external cloud services and software installed in guests can have separate accounts, licenses and charges. Installing Multipass does not purchase those services.

Sources: Official product, Installation and prerequisites, Source repository, Official releases.

At a glance

System
macOS 14 or later
Chip
Apple silicon · Intel
Auto-updates
No
Repository
Open source · GPL-3.0 · Updated 1 day ago★9.4K
Developer
Canonical Ltd.
Homebrew
Available; updated by Homebrew
Also known as
multipass
Homepage
github.com/canonical/multipass
Token
multipass

Checked

What’s new in 2018.12.1

New · From GitHub Releases

Highlights

  • On Linux, suspending/resuming the instance to/from disk is now supported. (#374)
  • Better handling of delayed shutdown including posting wall messages to logged in users and allowing log ins to the instance unless 1 minute or less remains until shutdown. (#461, #501)
  • On Linux, all CPU flags should be passed into the running instance on newly created instances. (#516)
  • Fixed some races around mount handling. (#514, #520)

Bugs fixed:

  • make the recover command idempotent (#528)
  • explicitly stop mounts when deleting an instance to avoid a race (#520)
  • be smarter about what group owns the multipass socket (#513, #523)
  • pass through all CPU flags when launching QEMU or libvirt instances (#516)
  • use info log level for metrics issues (#515)
  • fix potential race when starting a mount (#514)
  • use wall shutdown messages for users logged into VM when delayed shutdown is initiated (#501)
  • fix crash if exception during daemon start up (#487)
  • refactor CLI code (#468)
  • add default uid/gid mapping (#331)
  • fix file metadata passthrough
  • display uid/gid maps in info command (#439)
  • add support for the suspend command (#374)
  • shell to machine in delayed stop state (#461)
  • improve uid/gid validation (#479)
  • avoid leaking the libvirt bridge (#327, #413)
  • add a restart command (#217)
  • upgrade 3rd-party versions (#471)

How to install Multipass on Mac

Homebrew runs the multipass-1.17.2+mac-Darwin.pkg installer, which asks for an administrator password.

Install without Homebrew

Download the same file Homebrew uses: Install Details

Uninstall Multipass and optional data cleanup

Uninstall command
brew uninstall --cask multipass

A regular uninstall removes the app and keeps its settings and caches.

Deep clean (optional)
Uninstall command
brew uninstall --zap --cask multipass

--zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap.

Questions about Multipass

Is Multipass safe?

Multipass is in Homebrew’s official catalog and has not been disabled. Since September 2026, Homebrew disables apps that fail macOS Gatekeeper checks. When installing, Homebrew checks the download from github.com against its SHA-256 checksum. It was installed 3,098 times through Homebrew in the last 30 days.

Is Multipass open source?

Multipass’s source code is public on GitHub (canonical/multipass) under the GPL-3.0 license.

How do I completely uninstall Multipass on a Mac?

Run brew uninstall --cask multipass. It stops 1 background service and forgets 1 installer receipt. To delete its settings and caches as well, run brew uninstall --zap --cask multipass. --zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap. That also deletes 6 files and folders, including ~/Library/Application Support/com.canonical.multipassGui.

Does Multipass run on Apple silicon (M1 and later) Macs?

Homebrew installs it on both Apple silicon and Intel Macs, from the same download. It needs macOS 14 or later.

Where does Multipass store its settings and data?

Its data is in ~/Library/Application Support/com.canonical.multipassGui, ~/Library/Application Support/multipass, and ~/Library/Application Support/multipass-gui. These locations come from Homebrew’s clean-up list.

What is the latest version of Multipass?

The latest version is 1.17.2, added to Homebrew on Nov 18, 2026. Run brew upgrade --cask multipass to update it.

What else does installing Multipass add?

It installs through a .pkg installer, which asks for an administrator password.

Similar Apps

  • Podman DesktopFree graphical tools for containers and Kubernetes, with engine management, images, pods, volumes, logs, extensions and local-to-cluster workflows.
  • Rancher DesktopLocal container and Kubernetes development environment with a Linux VM, containerd or Docker-compatible Moby engine, and desktop management tools.
  • Oracle VirtualBoxCreate and manage local virtual machines on supported hosts; guest CPU compatibility and optional Extension Pack licensing vary.
  • FreelensFree Kubernetes desktop GUI for inspecting workloads, logs, metrics and resources across your existing clusters.
Browse all apps