Skip to content

Update Multipass installation instructions for macOS and correct Snap… #2435

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Oct 17, 2025
Merged

Update Multipass installation instructions for macOS and correct Snap… #2435

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 11 additions & 12 deletions content/install-guides/multipass.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,15 +53,15 @@ Multipass uses the terms virtual machine and instance synonymously.
Download Multipass for macOS.

```console
wget https://github.com/canonical/multipass/releases/download/v1.16.0/multipass-1.16.0+mac-Darwin.pkg
wget https://github.com/canonical/multipass/releases/download/v1.16.1/multipass-1.16.1+mac-Darwin.pkg
```

### How do I install Multipass on macOS?

Install the download using the package command.

```console
sudo installer -pkg multipass-1.16.0+mac-Darwin.pkg -target /
sudo installer -pkg multipass-1.16.1+mac-Darwin.pkg -target /
```

The getting started instructions below use the command line interface. If you prefer to use the graphical interface start it from the macOS Launchpad, the initial screen is shown below. You can use the UI to create, start, and stop virtual machines.
Expand Down Expand Up @@ -112,7 +112,7 @@ HINT: sudo /usr/sbin/kvm-ok

If KVM is available, proceed with the install.

### How do I install the Sanp daemon on Arm Linux?
### How do I install the Snap daemon on Arm Linux?

You may need to install the Snap daemon, `snapd`, before installing Multipass.

Expand All @@ -130,8 +130,6 @@ If you need to install `snapd` run:
sudo apt install snapd -y
```



{{% notice Note %}}
You can select from three Multipass releases: stable, beta, or edge. The default version is stable.
Add `--beta` or `--edge` to the install command below to select these more recent versions.
Expand Down Expand Up @@ -166,25 +164,26 @@ Multipass runs Ubuntu images. The last three LTS (long-term support) versions ar
To see the available images run the `find` command. Any of the listed images can be used to create a new instance.

```bash
sudo multipass find
multipass find
```

The output from `find` will be similar to the below.

```output
Image Aliases Version Description
20.04 focal 20240821 Ubuntu 20.04 LTS
22.04 jammy 20241002 Ubuntu 22.04 LTS
24.04 noble,lts 20241004 Ubuntu 24.04 LTS
daily:24.10 oracular,devel 20241009 Ubuntu 24.10
22.04 jammy 20251001 Ubuntu 22.04 LTS
24.04 noble,lts 20251001 Ubuntu 24.04 LTS
25.04 plucky 20251003 Ubuntu 25.04
daily:25.10 questing,devel 20251015 Ubuntu 25.10

Blueprint Aliases Version Description
Blueprint (deprecated) Aliases Version Description
anbox-cloud-appliance latest Anbox Cloud Appliance
charm-dev latest A development and testing environment for charmers
docker 0.4 A Docker environment with Portainer and related tools
jellyfin latest Jellyfin is a Free Software Media System that puts you in control of managing and streaming your media.
minikube latest minikube is local Kubernetes
ros-noetic 0.1 A development and testing environment for ROS Noetic.
ros2-humble 0.1 A development and testing environment for ROS 2 Humble.
ros2-jazzy 0.1 A development and testing environment for ROS 2 Jazzy.
```

### How do I launch a Multipass instance?
Expand Down
Loading