UTM guide authored by Jeffrey Fisher's avatar Jeffrey Fisher
# Tutorial: Installing Ubuntu in UTM
Author: Alvin Shen
# Table of contents:
[[_TOC_]]
# Preparing for Installing VM
1. Ensure you have at least `40GB` of free space
2. Download UTM from https://mac.getutm.app/
3. Download the Ubuntu ISO installer:
- Arm Apple Silicon Mac: https://cdimage.ubuntu.com/releases/focal/release/ubuntu-20.04.5-live-server-arm64.iso
- Intel Mac: https://releases.ubuntu.com/20.04/ubuntu-20.04.6-desktop-amd64.iso
# Creating the VM
1. Double-click the downloaded `UTM.dmg` and drag the app to the Applications folder
2. Open UTM from the applications menu
3. Click on the `Create a New Virtual Machine` button
4. Choose `Virtualize`, then `Linux`
5. Click `Browse...` and then find the Ubuntu iso that you downloaded
6. Leave the other options alone and click `Continue`
7. The default *Hardware*, *Storage*, and *Shared Directory* settings are fine, so just click `Continue` for those screens
- Note: for the *Storage* options, the VM won't consume the entire `64GB` until it is needed
8. On the *Summary* page you can give the VM a custom name like `r@m` and then click `Save`
9. Start the VM with the play button
10. Follow the *Apple Silicon Instructions* if you have an Apple Silicon Mac, otherwise follow *Intel Mac Instructions*
11. Follow the *Post-Install* instructions
# Intel Mac Instructions
1. Once the GRUB screen loads, press `Return/Enter` on your keyboard to install `Ubuntu`
1. A "Display output is not active" message might be on your screen for a couple of seconds until the install screen appears
2. Once the installer loads, click on the `Install Ubuntu` button
3. Ensure the keyboard layout matches your keyboard and click `Continue`
4. On the *Updates and other software* screen, choose `Minimal Installation` and then `Continue`
5. The default `Erase disk and Install Ubuntu` installation type is fine, so click `Install Now` and then `Continue` on the confirmation popup
- Note: you can disregard the erasing all data warning since we're installing it in a VM
6. Ensure the correct time zone is selected and then `Continue`
7. Fill in the fields on the *Who are you?* screen with whatever you want. Just make sure you remember the username and password. It's also recommended to make the username a single word, all lowercase, and relatively short.
8. The installation process will now begin. Let it install and update all the packages.
9. When the installation complete popup appears, choose `Restart Now`
10. Eject the iso with the disk icon in the top right of the window and then hit enter
![Screenshot of ejecting the disk in UTM on an Intel Mac](uploads/training/utm-eject-x64.png)
# Arm Apple Silicon Instructions
## Installing Ubuntu Server
This process is entirely keyboard-only, so you won't be able to use your mouse to interact with anything. Use the `Arrow Keys` and the `Return/Enter` key to navigate the terminal interface.
1. Once the GRUB screen loads, press `Return/Enter` on your keyboard to Install `Ubuntu Server`
2. A "Display output is not active" message might be on your screen for a couple of seconds until the install screen appears
3. Ensure `English` is the selected language and hit `Enter`
4. Skip the installer update, so hit `Enter`
5. Ensure `English (US)` is the selected keyboard layout and hit `Enter`
6. The default *Network Connections*, *Proxy*, and *Mirror* settings are fine, so hit `Enter` for those
7. The default *Storage* settings are also fine, so use the down arrow key until `Done` is selected and hit `Enter`
8. The *Storage Summary* screen should look something like this. Hit `Enter`, and a warning will appear. You can safely ignore the warning and choose `Continue` since we're using a VM
9. Fill in the fields on the Profile Setup with whatever you want. Just make sure you remember the username and password. It's also recommended to make the username a single word, all lowercase, and relatively short
10. Skip installing *OpenSSH* and choose `Done`
11. Skip the *Server Snaps* and choose `Done`
12. Let the installer install and update all the packages, and choose `Reboot Now` when it's done
13. When the screen goes black, eject the iso with the disk icon in the top right of the window, and then restart the VM
![Screenshot of ejecting the disk in UTM on an Arm Mac](uploads/training/utm-eject-arm.png)
## Install Ubuntu Desktop
1. Login with the username and password
- the password won't show anything on screen when you type, but it is working
2. Run the follow command and enter your password
- the password won't show anything on screen when you type, but it is working
```bash
sudo apt update && sudo apt upgrade -y && sudo apt install ubuntu-desktop-minimal -y
```
3. Once all the packages are installed and there are no errors run `sudo reboot`
# Post-Install
This is for both Apple Silicon and Intel Macs.
1. Login to your account
2. Skip through the welcome application's *Online Accounts*, *Livepatch*, *Help improve Ubuntu*, *Privacy*, and *Extra Software* pages
3. Choose `Don't Upgrade` when the *LTS Upgrade Available* popup appears
4. Install software updates if the *Software Updater* popup appears
5. Congrats you're done with setting up the Ubuntu VM!