Skip to content

Commit f1b7de7

Browse files
Merge pull request #1312 from jasonrandrews/review
Update multipass install guide
2 parents bae5968 + 9aef8bb commit f1b7de7

File tree

3 files changed

+21
-52
lines changed

3 files changed

+21
-52
lines changed
56.2 KB
Loading
-36 KB
Binary file not shown.

content/install-guides/multipass.md

Lines changed: 21 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -49,20 +49,20 @@ Multipass uses the terms virtual machine and instance synonymously.
4949
Download Multipass for macOS.
5050

5151
```console
52-
wget https://github.com/canonical/multipass/releases/download/v1.13.1/multipass-1.13.1+mac-Darwin.pkg
52+
wget https://github.com/canonical/multipass/releases/download/v1.14.1-rc1/multipass-1.14.1-rc1+mac.14+gf2381bfe9.mac-Darwin.pkg
5353
```
5454

5555
### Install
5656

5757
Install the download using the package command.
5858

5959
```console
60-
sudo installer -pkg multipass-1.13.1+mac-Darwin.pkg -target /
60+
sudo installer -pkg multipass-1.14.1-rc1+mac.14+gf2381bfe9.mac-Darwin.pkg -target /
6161
```
6262

63-
The getting started instructions below use the command line interface. Multipass installs a tray icon for those who want to access basic features from the user interface.
63+
The getting started instructions below use the command line interface. If you perfer 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.
6464

65-
![Connect #center](/install-guides/_images/multipass-tray.png)
65+
![Connect #center](/install-guides/_images/multipass-gui.png)
6666

6767
Multipass is now installed. Proceed to [Get Started with Multipass](#getstarted).
6868

@@ -168,10 +168,10 @@ The output from `find` will be similar to the below.
168168

169169
```output
170170
Image Aliases Version Description
171-
20.04 focal 20240626 Ubuntu 20.04 LTS
172-
22.04 jammy 20240701 Ubuntu 22.04 LTS
173-
23.10 mantic 20240701 Ubuntu 23.10
174-
24.04 noble,lts 20240702 Ubuntu 24.04 LTS
171+
20.04 focal 20240821 Ubuntu 20.04 LTS
172+
22.04 jammy 20241002 Ubuntu 22.04 LTS
173+
24.04 noble,lts 20241004 Ubuntu 24.04 LTS
174+
daily:24.10 oracular,devel 20241009 Ubuntu 24.10
175175
176176
Blueprint Aliases Version Description
177177
anbox-cloud-appliance latest Anbox Cloud Appliance
@@ -223,61 +223,30 @@ The `uname` output will look similar to:
223223
Linux m1u 6.8.0-36-generic #36-Ubuntu SMP PREEMPT_DYNAMIC Mon Jun 10 13:20:23 UTC 2024 aarch64 aarch64 aarch64 GNU/Linux
224224
```
225225

226-
### Run an application
227-
228-
It's helpful to demonstrate a few other common commands by downloading and installing an application. To demonstrate file copy, the download is done from macOS and the file is copied into the instance.
229-
230-
Download and install [OpenVSCode Server](/install-guides/openvscode-server/).
231-
232-
On the macOS host computer use `wget` for the download.
233-
234-
```console
235-
wget https://github.com/gitpod-io/openvscode-server/releases/download/openvscode-server-v1.90.0/openvscode-server-v1.90.0-linux-arm64.tar.gz
236-
```
237-
238-
To copy a file to the instance
239-
240-
```console
241-
multipass transfer openvscode-server-v1.90.0-linux-arm64.tar.gz m1u:/home/ubuntu
242-
```
243-
244-
Now switch to the instance and extract the download and run the application.
245-
246-
If you don't already have an open shell run.
247-
248-
```console
249-
multipass shell m1u
250-
```
251-
252-
Extract the download.
253-
254-
```console
255-
tar xvfz openvscode-server-v1.90.0-linux-arm64.tar.gz
256-
```
257-
258-
Run the application.
259-
260-
```console
261-
./openvscode-server-v1.90.0-linux-arm64/bin/openvscode-server --host=0.0.0.0 --without-connection-token
262-
```
263-
264-
Connect to OpenVSCode Server using a browser. From the macOS host computer use the `info` command to get the IP address of the instance.
226+
### Print information
265227

266228
The `info` command prints information about the instance, including the IP address.
267229

268230
```console
269231
multipass info m1u
270232
```
271233

272-
Copy the IP address from the info output and paste it into a browser with port 3000.
234+
The output is similar to:
273235

274-
Modify the IP address to use your information, for example:
275236
```output
276-
http://192.168.64.39:3000
237+
Name: m1u
238+
State: Running
239+
Snapshots: 0
240+
IPv4: 192.168.73.29
241+
Release: Ubuntu 24.04.1 LTS
242+
Image hash: e380b683b0c4 (Ubuntu 24.04 LTS)
243+
CPU(s): 4
244+
Load: 0.00 0.03 0.01
245+
Disk usage: 2.0GiB out of 15.4GiB
246+
Memory usage: 355.3MiB out of 3.8GiB
247+
Mounts: --
277248
```
278249

279-
You now have a running VS Code Server in your Multipass instance with Ubuntu 22.04 running on Arm.
280-
281250
### Mount a host directory
282251

283252
To access a large number of files on the host machine without copying or transferring them into the instance use the `mount` command. This command makes a host directory visible in the instance and all files can be accessed. Modifications made from inside the instance will directly change the files on the host.

0 commit comments

Comments
 (0)