canonical /multipass

Multipass orchestrates virtual Ubuntu instances

★ 9,395⑂ 845👁 117⑃ 2,856● 2,624▤ 68
C++GPL-3.0Created 2017-12-13canonical.com/multipass
Download: 1.17.11.17.1 ↓1.17.12026-11-13
+7
Daily
9,395
stars
845
forks
117
watchers
2,856
prs
2,624
issues
68
releases

README

What is Multipass?

Multipass is a lightweight VM manager for Linux, Windows and macOS. It's designed for developers who
want to spin up a fresh Linux environment with a single command. It uses QEMU on Linux, HCS (Host
Compute System) on Windows and QEMU or the Apple Virtualization Framework on macOS to run virtual
machines with minimal overhead. Multipass will fetch images for you and keep them up to date.

Since it supports metadata for cloud-init, you can simulate a small cloud deployment on your laptop or workstation.

 Project status

| Service                                              | Status                                          |
|------------------------------------------------------|:------------------------------------------------|
| CI | [![Linux CI][gha-image-linux]][gha-url-linux] [![Windows CI][gha-image-windows]][gha-url-windows] [![macOS CI][gha-image-macos]][gha-url-macos] |
| Snap                        | [![Build Status][snap-image]][snap-url]         |
| Codecov                       | [![Codecov Status][codecov-image]][codecov-url] |

 Installation

For more information, see How to install Multipass.

 Linux

Multipass is available as a snap:

  
  sudo snap install multipass
  

 macOS

Download the installer from GitHub.

  Alternatively, you can use Homebrew which is not
  officially supported, as it is not maintained by the Multipass team, but by the community. Multipass is available
  as a cask:

  
  brew install --cask multipass
  

  Please note that you may be required to enter your password for some sudo operations during installation. You may also
  need to disable the firewall to launch a multipass instance successfully on macOS.

 Windows

Download the installer from GitHub.

 Usage

Here are some pointers to get started with Multipass.


| Task | Command |
|----|----|
| List available images | multipass images |
| Launch an instance with the current Ubuntu LTS | multipass launch lts |
| List existing instances | multipass list |
| Get info about an instance | multipass info  |
| Connect to a running instance | multipass shell  |
| Run a command inside an instance | multipass exec  --  |
| Stop an instance | multipass stop  |
| Delete an instance | multipass delete  |
| Get help | multipass help  multipass help  |

For a more comprehensive learning experience, please check out the
Multipass Tutorial and consult the Multipass documentation.

 Building and Contributing

 Building Multipass

Please follow the platform-specific build instructions in the files below:

 BUILD.linux.md for Linux
 BUILD.macOS.md for macOS
 BUILD.windows.md for Windows

 Generic build tips

You may use your preferred package manager to install Multipass.
Note that only the official installers are supported.
See the installation guide for details.

For backend support and system requirements, refer to the
Multipass driver documentation.

If you notice outdated information or inconsistencies in these files, please open an issue or, 

Top issues

Discussions

Latest release

1.17.1 v1.17.1 2026-11-13
This Multipass 1.17.1 patch release fixes a vulnerability related to the transfer of files and an issue related to expanding ~ for target paths.

 Vulnerability & bug fixes

 - [sftp] Fix a potential vulnerability where a compromised instance could send malicious target paths to the host when executing multipass transfer leading to host files being changed without the user's consent. (5460)
 - [qemu] Expand "~" correctly for target paths (5417)

 Changes

See also the full diff: v1.17.0...v1.17.1.

 Feedback

Please file issues on the Multipass GitHub for problems and feature requ

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON