Install Ubuntu Server on a Raspberry Pi
Migrated from "How to install Ubuntu Server on your Raspberry Pi" on
ubuntu.com/tutorials.This guide needs to be tested and may need to be updated.
Overview
In this guide, we walk you through the process of installing Ubuntu Desktop on a Raspberry Pi.
What you’ll learn
- How to create a bootable Ubuntu Server microSD card
- How to setup internet connectivity on the Raspberry Pi
- How to access your Raspberry Pi remotely
What you’ll need
- A microSD card (4GB minimum, 8GB recommended)
- A computer with a microSD card drive
- A Raspberry Pi 2, 3 or 4
- A micro-USB power cable (USB-C for the Pi 4)
- A Wi-Fi network or an ethernet cable with an internet connection
And optionally:
- A monitor with an HDMI interface
- An HDMI cable for the Pi 2 & 3 and a micro HDMI cable for the Pi 4
- A USB keyboard
Prepare the SD Card
Following these steps will erase all existing content on the microSD card.
First, insert the microSD card into your computer.
Now you need to install the right Raspberry Pi Imager for your operating system. You can do this with the following links:
Or, if you are on Ubuntu, you can run:
sudo snap install rpi-imager
Once this is done, start the Imager and open the “CHOOSE OS” menu.
Here you you can select Ubuntu and see a list of download options. For this guide, we recommend you select the Ubuntu 24.04 LTS server for 64 bit architectures. As indicated in the imager this will work for the Raspberry Pi 3, 4 and Zero 2 W.
Select the image and open the “Choose Storage” menu. Select the microSD card you have inserted.
Before clicking ‘Write’ to flash your SD Card, click the cog icon to open a settings menu for advanced options.
Using Advanced Options
The Advanced options menu allows you to preconfigure a variety of network settings that would previously have required manual editing after flashing the SD card.
Here you can define the hostname of your Raspberry Pi and enable SSH, allowing you to connect to your Pi remotely.
We recommend setting SSH to use password authentication to make connecting remotely simpler. If you are interested in using public-keys with SSH you can read more about them here.
You can also configure your wi-fi connection in this menu, adding your SSID (wi-fi name) and Password. This will allow your Raspberry Pi to automatically connect to the internet as soon as the device starts. If you are connecting your Raspberry Pi to the internet via an ethernet cable, you can skip this step.
Once you have entered your details, click ‘Save’ and then ‘Write’ to flash your SD card.
Eject your SD card and insert it into your Raspberry Pi to continue to the next step.
Boot Ubuntu Server
If you are using an HDMI screen and a USB keyboard, ensure they are plugged in before powering on the Pi. You will be able to see the boot process on the screen.
During your first boot a tool called cloud-init is doing configuration. WAIT for it to finish before trying to log in. It typically takes less than 2 minutes but there is a break between the log-in prompt and cloud-init completing. If you interrupt the process you have to start again. You’ll know it’s done when it outputs some more lines after the log-in prompt has appeared.
Once cloud-init finishes, log in using the username and password you entered in the Advanced Setting menu. After a minute or so, Ubuntu on your Raspberry Pi will have fully booted and connected to the network.
Connect remotely to your Raspberry Pi
To connect to your Raspberry Pi remotely, you need two things (we’ll help you find them):
- Its IP address on the local network
- An SSH client (SSH is a communication protocol between machines)
You have to do this if you are running your device headless, but you might also want to do this if you are not, so you can access your Pi from anywhere.
Determining the Pi’s IP address
The easiest way to determine your Raspberry Pi’s IP address is by opening the dashboard for your wifi router and looking for connected devices. If you set a hostname in the ‘Advanced options’ this should appear as your device name.
If you don’t have access to your router dashboard you can temporarily connect a monitor and keyboard to your Raspberry Pi and run:
hostname -I
Which will return your device’s IP (Note: in this case the command uses the actual word ‘hostname’, not the hostname you defined in Advanced options).
Using an SSH client
On Ubuntu and Mac OS, an SSH client is already installed. If you are on Windows you can either use Ubuntu on WSL or the built-in SSH client in the Windows terminal.
Open a terminal and run the following command:
ssh <username>@<Raspberry Pi’s IP address>
or:
ssh <username>@<hostname>
If you set one up in the Advanced options menu.
You will be asked to confirm the connection:
Are you sure you want to continue connecting (yes/no/[fingerprint])?
Type “yes” to confirm. You will then be asked to sign in with your username and password.
If you did not create a username and password in the Advanced options menu, the username and password will both be ‘ubuntu’ by default and you will be asked to create a new password at this stage. Once done, you can reconnect again with the SSH command and the new password.
You are now connected to Ubuntu Server running on your Raspberry Pi.
Still not connected to the internet?
Sometimes the structure of the network-config file that you modified before boot gets messed up when you boot. This would cause your Pi not to be able to connect to your wi-fi.
To fix this you need to go into the correct file and correct the issue. Run:
sudo nano /etc/netplan/50-cloud-init.yaml
so you can edit the file. Edit it so it looks like this again, the indentation needs to be correct for the .yaml to work:
wifis:
wlan0:
dhcp4: true
optional: true
access-points:
"home network":
password: "123456789"
Save and exit the file with Ctrl + S and Ctrl + X.
Run sudo netplan apply and sudo reboot and when you log back in, you will be connected to your wifi.
Installing a desktop environment
Depending on what you are going to use your Pi for, you may want a desktop environment to run graphical applications.
You can find guidance in install a desktop environment on Ubuntu server.
Next steps
You up and running on Ubuntu Server.
For more details about Raspberry Pi specific packages included with this image and further customisations, such as accelerated video drivers and optional package repositories, you can refer to the RaspberryPi wiki.
You also might want to install some software on your Pi. Ubuntu has extensive repositories available, that you can browse at packages.ubuntu.com. You can also use the snap command to install snap packages. The Snap Store is where you can find the best Linux open source and proprietary apps to install on your Raspberry Pi and get started with any project.