canonical /multipass
Multipass orchestrates virtual Ubuntu instances
★ 9,395⑂ 845👁 117⑃ 2,856● 2,624▤ 68
+7
日增长
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
#566Consider a different location for Multipass files on macOS48 comments · 2019-01-19#3662Multipass unable to connect and retrieve images without IPv6 on WAN42 comments · 2024-09-04#309Port forwarding (`multipass forward`)38 comments · 2018-07-04#4202Native mounts do not work on Windows 11 with Hyper-V37 comments · 2025-07-01#2303Additional disk device (/dev/sdb) on Multipass instance37 comments · 2021-10-20#255Rename instance36 comments · 2018-05-22#1039[launch] deal with very long cloud-init times35 comments · 2019-09-11#2167Multipass won't start if systemd-resolved is disabled32 comments · 2021-07-06
Discussions
#5488Supported recovery after an interrupted start request on macOS — Multipass 1.16.30 comments · 2026-10-29#4994Upgrading CXX_STANDARD to 23, then replace fmt lib with std::format and std::print1 comments · 2026-06-26#4357Port forwarding1 comments · 2025-09-10#4317How can I specify the `native` mount type for a mount (i.e. `--mount`) as part of a `launch` command?1 comments · 2025-08-22#4303Static IP for instances in future release2 comments · 2025-08-14#4241Does Multipass collect any kind of telemetry/usage data?0 comments · 2025-07-11#4097Multipass on macOS Sequoia 15.51 comments · 2025-05-19#4092Ubuntu0 comments · 2025-05-18
Latest release
1.17.1 v1.17.1 2026-11-13This 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