[doc] Update tutorial and ubuntu LTS versions#4945
Open
chrisndbg wants to merge 12 commits into
Open
Conversation
chrisndbg
changed the title
chrisndbg
changed the title
chrisndbg
force-pushed
the
docs-update-tutorial-and-ubuntu-lts-versions
branch
3 times, most recently
from
013abf6 to
9145f4a
Compare
Contributor
There was a problem hiding this comment.
Pull request overview
Updates Multipass documentation examples to reflect current Ubuntu LTS (26.04) and recent multipass find output, while restructuring parts of the main tutorial to be more coherent across platforms.
Changes:
- Refresh tutorial and CLI reference sample outputs to Ubuntu 26.04 and updated
multipass findlistings. - Rework tutorial flows for creating customized instances and managing instances, aiming for consistent instance names across platforms.
- Simplify the “Run a simple web server” tutorial portion and consolidate screenshots.
Reviewed changes
Copilot reviewed 12 out of 15 changed files in this pull request and generated 7 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/tutorial/index.md | Updates tutorial outputs to Ubuntu 26.04, restructures customized/manage sections, and updates screenshots. |
| docs/reference/command-line-interface/suspend.md | Updates sample multipass list output to Ubuntu 26.04 LTS. |
| docs/reference/command-line-interface/shell.md | Updates sample shell banner output to Ubuntu 26.04 LTS. |
| docs/reference/command-line-interface/list.md | Updates sample list outputs (table + YAML) to Ubuntu 26.04 LTS. |
| docs/reference/command-line-interface/info.md | Updates sample info outputs (table + YAML) to Ubuntu 26.04 LTS and new fields (e.g., Zone). |
| docs/reference/command-line-interface/find.md | Updates sample find output to current image list format/content. |
| docs/how-to-guides/manage-instances/use-the-primary-instance.md | Updates sample list output images to Ubuntu 26.04 LTS. |
| docs/how-to-guides/manage-instances/use-an-instance.md | Updates sample shell banner output to Ubuntu 26.04 LTS. |
| docs/how-to-guides/manage-instances/remove-an-instance.md | Updates sample list output release to Ubuntu 26.04 LTS. |
| docs/how-to-guides/manage-instances/modify-an-instance.md | Updates sample list output images to Ubuntu 26.04 LTS. |
| docs/how-to-guides/manage-instances/create-an-instance.md | Updates sample find/info outputs to Ubuntu 26.04 and new formatting/fields. |
| docs/how-to-guides/customise-multipass/set-up-a-graphical-interface.md | Updates sample list/info outputs to Ubuntu 26.04 and new fields (e.g., Zone). |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
chrisndbg
force-pushed
the
docs-update-tutorial-and-ubuntu-lts-versions
branch
from
0951886 to
9b3f74b
Compare
geoffreynyaga
previously approved these changes
Jun 23, 2026
github-merge-queue
Bot
removed this pull request from the merge queue due to a conflict with the base branch
github-merge-queue
Bot
removed this pull request from the merge queue due to failed status checks
7 tasks
- updated to use Ubuntu 26.04 LTS across examples - updated 'find' output to reflect latest changes - restructured "Create a customised instance" and "Manage instances" sections to be coherent - using the same instance name "coherent-trumpetfish" across all platforms to match "Manage instances" section
chrisndbg
force-pushed
the
docs-update-tutorial-and-ubuntu-lts-versions
branch
from
9b3f74b to
136f90c
Compare
Collaborator
Author
|
@geoffreynyaga - I had to rebase after #4946 merged to |
| --> | ||
|
|
||
| Clicking this button does many things in the background. First, it creates a new virtual machine (instance) named "primary", with 1GB of RAM, 5GB of disk, and 1 CPU. Second, it installs the most recent Ubuntu LTS release on that instance. Third, it mounts your `$HOME` directory in the instance. Last, it opens a shell to the instance, announced by the command prompt `ubuntu@primary`. | ||
| Clicking this button does many things in the background. First, it creates a new virtual machine (instance) named "primary", with 1GB of RAM, 5GB of disk, and 1 CPU. Then, it installs the most recent Ubuntu LTS release on that instance. Last, it opens a shell to the instance, announced by the command prompt `ubuntu@primary`. |
Comment on lines
74
to
+75
| Launched: primary | ||
| Mounted '/home/<user>' into 'primary:Home' | ||
| Welcome to Ubuntu 22.04.1 LTS (GNU/Linux 5.15.0-57-generic x86_64) | ||
| Welcome to Ubuntu 26.04 LTS (GNU/Linux 7.0.0-15-generic x86_64) |
| Perhaps after using this instance for a while, you decide that what you really need is the latest LTS version of Ubuntu, with a more informative name and a little more memory and disk. You can delete the "coherent-trumpetfish" instance by running the following command: | ||
|
|
||
| `multipass delete coherent-trumpetfish` | ||
| This tells multipass to run the command `lsb_release -a` on the "coherent-trumpetfish" instance. |
| $ multipass info ltsInstance | ||
| Name: ltsInstance | ||
| State: Running | ||
| IPv4: 10.110.66.139 |
| C:\WINDOWS\system32> multipass info ltsInstance | ||
| Name: ltsInstance | ||
| State: Running | ||
| IPv4: 10.110.66.139 |
Comment on lines
9
to
+11
| Name State IPv4 Release | ||
| primary SUSPENDED -- Ubuntu 18.04 LTS | ||
| calm-squirrel RUNNING 10.218.69.109 Ubuntu 16.04 LTS | ||
| primary SUSPENDED -- Ubuntu 26.04 LTS | ||
| calm-squirrel RUNNING 10.218.69.109 Ubuntu 26.04 LTS |
Comment on lines
27
to
+36
| primary: | ||
| - state: SUSPENDED | ||
| ipv4: | ||
| - "" | ||
| release: 18.04 LTS | ||
| release: 26.04 LTS | ||
| calm-squirrel: | ||
| - state: RUNNING | ||
| ipv4: | ||
| - 10.218.69.109 | ||
| release: 16.04 LTS | ||
| release: 26.04 LTS |
Comment on lines
40
to
+41
| Name State IPv4 Release | ||
| keen-yak STOPPED -- Ubuntu 18.04 LTS | ||
| keen-yak STOPPED -- Ubuntu 26.04 LTS |
Comment on lines
+10
to
+12
| State: Running | ||
| Zone: zone1(a) | ||
| Snapshots: 0 |
| @@ -18,7 +18,7 @@ If check your instances with `multipass list`, you'll see that its status is now | |||
|
|
|||
Collaborator
Author
@geoffreynyaga - you can wait with the approval. I just realized that the "Open Shell" menu item in the taskbar is not available anymore. WIth that, the entire section on how to start the first/primary instance needs to be adapted... I see two options:
what do you think? |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
What does this PR do?
Update the main Multipass tutorial, including
multipass findoutput to reflect latest changes, e.g. no blueprintsWhy is this change needed?
The tutorial was showing outdated examples and was not consistent across some sections.
Testing
In
docsfolder:make runand checked result in local previewmake spellingmake linkcheckChecklist
MULTI-2674