UPDATE 12/5/20 – New instructions are available for Ubuntu 20.04 or Ubuntu 20.10 installation and USB booting on Raspberry Pi 4 in my new article here
Ubuntu Server has been my favorite Linux distribution for years. On everything but the Raspberry Pi I run Ubuntu Server but felt stuck with Raspbian on the Pi. Until now! Ubuntu Server 18.04.2 has been released and major improvements have been made to the official Pi branch.
The Raspberry Pi 4 is not officially supported out of the box yet on the current Ubuntu Server Raspberry Pi images but you can get it working by manually updating the firmware. Solid state storage is also working but with the catch of having to use a micro SD card as a bootloader since the Pi 4 does not have official boot support yet. I describe how to do both in this article.
The Raspberry Pi’s peripherals such as WiFi / Bluetooth are now fully supported. Previous Ubuntu Server versions for Raspberry Pi (like many other distros) had broken or completely missing drivers for core components such as WiFi / Bluetooth. In the 18.04.2 update the firmware for the WiFi and other components is now included out of the box making it a fully functional distribution!
This is the first distribution besides Raspbian that feels like you can just image it and everything works. I’ll guide you through the process in this guide. It only takes a few minutes to set up.
Recommended Gear
I highly recommend upgrading to a solid state setup. The performance gains are gigantic. It’s now less than 30 bucks to take your Pi solid state. This is the best performance upgrade you can possibly get for a Pi.
With the new Raspberry Pi 4 it’s even more beneficial to use USB storage since a USB 3.0 bus was finally added in the Pi 4 letting it take full advantage of solid state drives. This is the setup I am currently using:
The Raspberry Pi 4 is available in different memory configurations all the way up to 8 GB. It’s about the size of a credit card and uses an extremely low amount of power making it ideal for all sorts of projects and ideas!
Links: AliExpress*, Amazon.com*, Amazon.ca*, Amazon.com.au*, Amazon*.co.jp*, Amazon.co.uk*, Amazon.de*, Amazon.es*, Amazon.fr*, Amazon.it*, Amazon.nl*, Amazon.pl*, Amazon.se*, Amazon.sg*
The Raspberry Pi 400 kit includes everything you need for a full Pi 400 desktop build. The Pi 400 is the fastest Raspberry Pi ever released and comes in the form factor of a keyboard!
Links: AliExpress*, Amazon.com*, Amazon.ca*, Amazon.com.au*, Amazon.co.jp*, Amazon.co.uk*, Amazon.de*, Amazon.es*, Amazon.fr*, Amazon.it*, Amazon.nl*, Amazon.pl*, Amazon.se*, Amazon.sg*
The Kingston A400 has been a great drive to use with the Pi for years. It’s reliable, widely available around the world, has low power requirements and performs very well. It’s also very affordable. This drive has been benchmarked over 1000 times at Pi Benchmarks and is the #1 most popular SSD among the Pi community!
Links: AliExpress*, Amazon.com*, Amazon.ca*, Amazon.com.au*, Amazon.co.jp*, Amazon.co.uk*, Amazon.de*, Amazon.es*, Amazon.fr*, Amazon.it*, Amazon.nl*, Amazon.pl*, Amazon.se*, Amazon.sg*
The USB 3.1 variant of the StarTech 2.5″ SATA adapter works well with the Pi 4. The USB 3.0 variant doesn’t have firmware updates available and is not recommended.
Links: Amazon.com*, Amazon.ca*, Amazon.com.au*, Amazon.co.jp*, Amazon.co.uk*, Amazon.de*, Amazon.es*, Amazon.fr*, Amazon.it*, Amazon.nl*, Amazon.pl*, Amazon.se*, Amazon.sg*
Or for a compact setup:
The SanDisk Extreme Pro USB SSD is a true solid state drive. This is different than a typical “flash drive” which uses extremely cheap memory and has very low random I/O performance/throughput compared to a real solid state drive. I’ve used both the USB 3.1 and USB 3.2 variants with the Pi successfully and they benchmark very well!
Links: AliExpress*, Amazon.com*, Amazon.ca*, Amazon.com.au*, Amazon.co.jp*, Amazon.co.uk*, Amazon.de*, Amazon.es*, Amazon.fr*, Amazon.it*, Amazon.nl*, Amazon.pl*, Amazon.se*, Amazon.sg*
SD Card Setup:
The SanDisk Extreme A1-A2 SD card has the best scoring SD card on Pi Benchmarks for years and is second in popularity only to the SanDisk Ultra (often included in combo kits). The application class (A1) means random I/O speeds (very important when running an OS) have to meet a higher standard. There’s no benefit on the Pi for A2 right now so get whichever is cheaper/available.
Links: AliExpress*, Amazon.com*, Amazon.ca*, Amazon.com.au*, Amazon.co.jp*, Amazon.co.uk*, Amazon.de*, Amazon.es*, Amazon.fr*, Amazon.it*, Amazon.nl*, Amazon.pl*, Amazon.se*, Amazon.sg*
These storage choices are ones that all scored highly on the end-user submitted Raspberry Pi Storage Benchmarks and will give you outstanding I/O performance on the Raspberry Pi. I also personally own all of them and recommend them knowing they are compatible and perform well on the Pi.
Getting Ubuntu Server
64 bit (aarch64)
I have a custom compiled prebuilt 64 bit image available for testing. This version supports addressing all 4 GB of RAM if available. The WiFi fix for bootflags3 is also already implemented into the precompiled version. Get my custom built kernel from the Ubuntu-Server-raspi4-unofficial GitHub page.
32 bit (armhf)
To get the 32 bit version head to the official Ubuntu Raspberry Pi page at https://wiki.ubuntu.com/ARM/RaspberryPi and scroll to the “Official Images” section. Until the official Raspberry Pi 4 image is released choose the Raspberry Pi 3B+ armhf release and follow the directions in the next sections to update the firmware for a Pi 4 boot.
Writing the Base Image
This part is easy. Extract the image from xz format to img format (7zip is great and free and can extract these). Now write the img to your media (Micro SD card, solid state drive, USB storage, etc). the same way you would for any other distribution!
Updating Firmware for Raspberry Pi 4
If you are using the CloudKernel 64 bit image you can skip to the “Boot Ubuntu Server” section as it already implements the updated firmware. If you are using the 32 bit image or the official Ubuntu Server preinstalled server image from Ubuntu’s web site you will need to update the firmware using these instructions.
Remove Existing Firmware
The firmware in the current release was not built with Raspberry Pi 4 support so we need to update the firmware on the /boot/ partition for the Pi 4 to be able to boot correctly.
Insert/mount the micro SD card in your computer and navigate to the “boot” partition. Delete everything in the existing folder so it is completely empty.
Download Latest Firmware
32 bit Firmware Instructions
If you are trying to run the 64 bit version of Ubuntu skip to the 64 bit instruction section next. For 32 bit versions of Ubuntu download the firmware from the official GitHib repository here: Raspberry Pi GitHub Official – master.zip
The latest firmware is everything inside master.zip “boot” folder (including subfolders). We want to extract everything from “boot” (including subfolders) to our micro SD’s “boot” partition that we just emptied in the previous step. Don’t forget to get the “overlays” folder as that contains overlays necessary to boot correctly.
The end result will look something like this on the “boot” drive:
$ ls COPYING.linux bcm2711-rpi-4-b.dtb kernel.img LICENCE.broadcom bootcode.bin kernel7.img 'System Volume Information' cmdline.txt kernel7l.img bcm2708-rpi-b-plus.dtb config.txt overlays bcm2708-rpi-b.dtb fixup.dat start.elf bcm2708-rpi-cm.dtb fixup4.dat start4.elf bcm2708-rpi-zero-w.dtb fixup4cd.dat start4cd.elf bcm2708-rpi-zero.dtb fixup4db.dat start4db.elf bcm2709-rpi-2-b.dtb fixup4x.dat start4x.elf bcm2710-rpi-3-b-plus.dtb fixup_cd.dat start_cd.elf bcm2710-rpi-3-b.dtb fixup_db.dat start_db.elf bcm2710-rpi-cm3.dtb fixup_x.dat start_x.elf
64 bit Firmware Instructions
To boot Ubuntu Server in 64 bit mode we need to download the 64 bit version of the firmware. The .dtb files are different between 32 bit and 64 bit operating systems. Raspbian does not come with a 64 bit bootloader and one isn’t provided in the official GitHub repo either.
I have these 64 bit versions available in my Ubuntu Server precompiled image.
Create/Update config.txt and cmdline.txt
Navigate to the micro SD /boot/ partition. Create a blank cmdline.txt file with the following line:
dwc_otg.fiq_fix_enable=2 console=ttyAMA0,115200 kgdboc=ttyAMA0,115200 console=tty1 root=/dev/mmcblk0p2 rootfstype=ext4 rootwait rootflags=noload net.ifnames=0
Next we are going to create config.txt with the following content:
# Enable audio (loads snd_bcm2835) dtparam=audio=on [pi4] [all]
64 bit config.txt Configuration
To boot the Pi in 64 bit mode we need to add the following lines to the config.txt:
arm_64bit=1 enable_gic=1 armstub=armstub8-gic.bin
The final configuration for 64 bit will look like this:
# Enable audio (loads snd_bcm2835) dtparam=audio=on [pi4] arm_64bit=1 enable_gic=1 armstub=armstub8-gic.bin [all]
These enable all the different 64 bit related options you need to perform a 64 bit boot on the Pi.
Boot Ubuntu Server
We are now ready to boot the device. Insert the micro SD card and power on the device.
Note: The very first startup can be very slow. Be patient. It can take up to a couple minutes with no activity lights then all the sudden everything will start blinking and SSH will open up.
Fix apt-get update / Prevent Further Updates
If you try to apt-get update now it will try to update your firmware with older firmware from the Ubuntu repository. The workaround for now is to remove that package so it keeps your existing firmware. Make a note to remember you did this step as later on we will want to reenable updates from the repository once support has been added.
sudo apt-mark hold flash-kernel
You may now run sudo apt-get update && sudo apt-get upgrade. I would avoid using dist-upgrade yet because the kernels in the repository it will update you to don’t support the Pi 4 yet. But this should get you all up to date on the packages!
Once the firmware in the apt repositories has been updated for the Pi 4 it will be safe to reinstall initramfs-tools and let it update through the normal process again.
Solid State Drive (SSD) Configuration (Optional)
USB booting has not been added into the Raspberry Pi 4 firmware yet but is being worked on right now. In the mean time you can use your micro SD card as a bootloader and still boot the whole operating system (rootfs) from the solid state drive giving you the full USB 3.0 speed increases system wide. Once the Pi USB booting is officially released you should be able to boot directly from the device without any makeshift bootloader SD card necessary.
First create a fully imaged and booting micro SD card following the earlier steps in the tutorial. After you have created the micro SD installation you should now image your SSD / USB drive with the same Ubuntu image you used to create the SD card.
Now navigate to the “boot” partition on the newly created SSD / USB drive and remove everything in there just like we did with the SD card earlier. Now copy the “boot” folder from the micro SD card to the solid state drive. This is necessary because even though the files in “boot” are read off our micro SD card initially some firmware files in the later load stages are read off the mounted drive and if the necessary firmware files are missing the system won’t boot.
Now that you’ve created the SSD / USB drive partitions and copied the “boot” partition from the SD card to your new drive we need to update your SD card’s cmdline.txt to point to the SSD / USB drive’s partition.
dwc_otg.fiq_fix_enable=2 console=ttyAMA0,115200 kgdboc=ttyAMA0,115200 console=tty1 root=/dev/mmcblk0p2 rootfstype=ext4 rootwait rootflags=noload net.ifnames=0
The key part we need to change here is the “root=/dev/mmcblk0p2” section. mmcblk0p2 is a hardware identifier for micro SD storage. We need to change this to the device your storage is detected as.
If you are using a USB to solid state drive adapter it’s very likely your drive will be addressed as /dev/sda2. Therefore we will change the root=/dev/mmcblk0p2 to root=/dev/sda2
root=/dev/sda2
The final line will be:
dwc_otg.fiq_fix_enable=2 console=ttyAMA0,115200 kgdboc=ttyAMA0,115200 console=tty1 root=/dev/sda2 rootfstype=ext4 rootwait rootflags=noload net.ifnames=0
Plug both the micro SD and the solid state drive into the Pi and boot it up.
Remember: the first boot can take 2-3 minutes for first startup so give it some time before assuming it didn’t work.
Wireless Fix
The current non-free Raspberry Pi firmware had the wrong bootflags3 for quite a while for the Raspberry Pi 4 and these firmware files are definitely out there. Here is a one liner I wrote to replace the Raspberry Pi 3 boot flags in this driver with the Raspberry Pi 4 one:
sudo sed -i "s:0x48200100:0x44200100:g" /lib/firmware/brcm/brcmfmac43455-sdio.txt
Restart the system afterward.
Configuration
Default User / Password
The username and password for your initial login to Ubuntu Server will be:
user: ubuntu password: ubuntu
You will be required to change your password after logging in for the first time. Make sure on the prompt you enter the current “ubuntu” password before typing in your new password or the device will kick you out completely and you’ll have to log in again.
Set Time Zone
To configure the correct time zone for Ubuntu Server use the following command:
sudo dpkg-reconfigure tzdata
This will take you to a very easy to follow menu to select your correct time zone and applies it to the system.
Update System
For best stability, security and performance you should immediately update your system and packages to the latest version. This will also grab all of the latest fixes/improvements making your Raspberry Pi Ubuntu experience much better.
This part is easy. Type:
sudo apt-get update && sudo apt-get upgrade
Change Default GPU Memory Split
The default amount of memory allocated to the GPU on the Raspberry Pi is around 76 MB of our 1 GB. In 2 GB and 4 GB models the amount gained from this is negligible but is still worth it for the 1 GB model.
If you type the command “free” you will see that your Raspberry Pi is missing this memory under the “total” column. We can reclaim most of this memory back by setting the GPU memory split to 16 MB. If you are planning on installing a GUI in the future you should not make this change.
This option is set in the config.txt file. It’s exactly the same file as Raspbian uses but it is located at /boot/firmware/config.txt instead of /boot/config.txt. Open config.txt with the following command:
sudo nano /boot/firmware/config.txt
We will add the following line at the bottom of config.txt:
gpu_mem=16
Press Ctrl + X and type yes to save the file. Now restart the Pi by typing
sudo reboot
After the reboot finishes type “free” again and you will see that your total available memory has increased and can now be used by the system and your applications!
Benchmarking / Testing Storage
If you want to verify your drive’s performance you may want to run my storage benchmark with:
sudo curl https://raw.githubusercontent.com/TheRemote/PiBenchmarks/master/Storage.sh | sudo bash
If you search for the model of your drive on Pi Benchmarks you can compare your score with others and make sure the drive is performing correctly!
Conclusion
I’m very excited to see my favorite Linux distributions continue to evolve to the point where they are comparable in performance and stability to Raspbian. I’ve been testing extensively on Ubuntu Server 32 bit and 64 bit for my Raspberry Pi Minecraft Server project and not only is it on par with Raspbian but starting to do things so well it sometimes makes Raspbian feel a little dated.
If you have any questions or suggestions don’t hesitate to leave me a comment on the post or use my contact form to message me privately! I’m good about responding quickly and my articles are constantly revised to address questions or do something a better way that a reader pointed out.
Have fun!
ubuntu@ubuntu:~$ sudo apt-get upgrade -y
Reading package lists... Done
Building dependency tree
Reading state information... Done
Calculating upgrade... Done
The following packages have been kept back:
linux-headers-raspi2 linux-image-raspi2 linux-raspi2
0 upgraded, 0 newly installed, 0 to remove and 3 not upgraded.
1 not fully installed or removed.
After this operation, 0 B of additional disk space will be used.
Setting up initramfs-tools (0.130ubuntu3.8) ...
update-initramfs: deferring update (trigger activated)
Processing triggers for initramfs-tools (0.130ubuntu3.8) ...
update-initramfs: Generating /boot/initrd.img-4.15.0-1041-raspi2
W: mkconf: MD subsystem is not loaded, thus I cannot scan for arrays.
W: mdadm: failed to auto-generate temporary mdadm.conf file.
Unsupported platform.
run-parts: /etc/initramfs/post-update.d//flash-kernel exited with return code 1
dpkg: error processing package initramfs-tools (--configure):
installed initramfs-tools package post-installation script subprocess returned error exit status 1
Errors were encountered while processing:
initramfs-tools
E: Sub-process /usr/bin/dpkg returned an error code (1)
ubuntu@ubuntu:~$
SAME WITH YOU !
I’m stuck at “Once the firmware in the apt repositories has been updated for the Pi 4 it will be safe to reinstall initramfs-tools and let it update through the normal process again.”
How do I do this?
Hi there!
I’m playing with bluetooth and it seems there is a bug and it is using wrong firmware dir. As temporary fix you can use this command:
sudo ln -s /lib/firmware /etc/firmware
To check it you can use:
sudo hciattach /dev/ttyAMA0 bcm43xx 921600 -
Hey Joan,
Wow another one! I’ll add this into the v2 image.
Hi, am michael again, I just posted an issue that I had with my brand new rasperry, I managed to control it but not fix it, cuz it will only happen when I reboot the system, so I have to just turn it off and then wait a couple of minute to plug it back in, and whoala! Everything works good it boots succesfully,
It is weird, some forums speak about the power supply not being enough, but mine is the original, it has 5.0V and 3.0 A. Luckily after I wait it boot, but now getting all my stuff propperly intalled I ran into a new issue, which is;
The system telling me that I’ve used all my space, which is not trueth i barely have the ubuntu files in it, here is what it says:
Usage of /: 100.0% of 58.25GB
Welcome to Ubuntu 18.04.3 LTS (GNU/Linux 4.19.67-v8+ aarch64)
* Documentation: https://help.ubuntu.com
* Management: https://landscape.canonical.com
* Support: https://ubuntu.com/advantage
System information as of Thu Aug 29 15:30:24 EST 2019
System load: 0.0 Processes: 110
Usage of /: 100.0% of 58.25GB Users logged in: 0
Memory usage: 7% IP address for eth0: 192.168.1.190
Swap usage: 0%
=> / is using 100.0% of 58.25GB
* Keen to learn Istio? It's included in the single-package MicroK8s.
https://snapcraft.io/microk8s
0 packages can be updated.
0 updates are security updates.
Last login: Thu Aug 29 14:55:40 2019 from 192.168.1.154
ubuntu@ubuntu:~$ sudo su root@ubuntu:/home/ubuntu# cd /
root@ubuntu:/# sudo du -sh * .
3.4TNAS
12Kbash
14Mbin
112Mboot
0dev
5.0Metc
60Khome
814Mlib
16Klost+found
4.0Kmedia
4.0Kmnt
4.0Kopt
du: cannot access 'proc/1763/task/1763/fd/3': No such file or directory
du: cannot access 'proc/1763/task/1763/fdinfo/3': No such file or directory
du: cannot access 'proc/1763/fd/3': No such file or directory
du: cannot access 'proc/1763/fdinfo/3': No such file or directory
0proc
76Kroot
11Mrun
16Msbin
8.0Ksnap
4.0Ksrv
0sys
40Ktmp
1.1Gusr
295Mvar
8.0K.
root@ubuntu:/#
Hey Michael,
If you are using the precompiled image from this guide on the Raspberry Pi 3 it’s definitely not going to work since that image will only work on the Pi 4. Are you using the official ones from Ubuntu for Pi 3?
Yes I am using the image yes am using pi4 b
– Raspberry Pi 4 b ( Just got it yesterday is brand new! ).
– Power Supplier also brand new and the original one!
– Sandisk 64gb Serie U1 and also I tried with Samsung 64gb U3.
Ok got it, have you tried running Raspbian on it yet?
Yes raspian worked good with the storage issue I mentioned, however the reboot thing happens as well with raspian, so I happen to reboot the device I have to make sure it remains off for at least 20 minutes, then it boots just fine.
Hi there!
I achived to install Gnome Desktop ontop and it works very well, not super fast but enough.
Thanks again for the god job.
Hey Joan,
Sorry that I wasn’t up for the rest of this as I had to sleep! I’m glad you got it working and it looks like you found a better method to stop this updating! I’ll update the documentation today.
No worries, it’s always challenging and rewarding to find the solution XD.
Hi, first of all, thanks for this great job!
I’m experiencing some problems configuring the image.
1- ubuntu@ubuntu:~$ systemctl status systemd-modules-load.service
● systemd-modules-load.service - Load Kernel Modules
Loaded: loaded (/lib/systemd/system/systemd-modules-load.service; static; vendor preset: enabled)
Active: failed (Result: exit-code) since Sun 2018-01-28 15:58:18 UTC; 1 years 6 months ago
Docs: man:systemd-modules-load.service(8)
man:modules-load.d(5)
Main PID: 125 (code=exited, status=1/FAILURE)
2- Every time y run apt it ends like this:
(...)
update-initramfs: deferring update (trigger activated)
Processing triggers for initramfs-tools (0.130ubuntu3.8) ...
update-initramfs: Generating /boot/initrd.img-4.15.0-1041-raspi2
W: mdadm: failed to auto-generate temporary mdadm.conf file.
W: mkconf: MD subsystem is not loaded, thus I cannot scan for arrays.
Unsupported platform.
run-parts: /etc/initramfs/post-update.d//flash-kernel exited with return code 1
dpkg: error processing package initramfs-tools (--configure):
installed initramfs-tools package post-installation script subprocess returned error exit status 1
Errors were encountered while processing:
initramfs-tools
Sorry it this is not the place to post that.
Thanks!
Hey Joan,
The Ubuntu image is trying to update your firmware with the old outdated firmware from the Ubuntu repositories but since there’s no Pi 4 support yet it has no idea how to even talk to it! To prevent this, use this command:
sudo apt-mark hold flash-kernel
You may now update normally! Avoid dist-upgrade for now as it will just attempt to replace the modified firmware by reinstalling flash-kernel on you. For the time being the modified firmware is the only thing letting the Pi 4 run it. Once official support comes to the main Ubuntu repository you can simply unhold the package and switch back to Ubuntu firmware updates.
Hi James, thanks for the answer. The first command i did after boot was: “sudo apt-mark hold flash-kernel” so:
ubuntu@ubuntu:~/util$ sudo apt-mark hold flash-kernel
flash-kernel was already set on hold.
I don’t understand why is keep trying to update with old firmware.
Hey Joan,
Can you try sudo apt remove flash-kernel? This might be my mistake, I may have removed it and then put it on hold. If something seems stuck you may want to sudo apt upgrade –fix-broken as well.
If this works for you let me know and I will update all the instructions!
I forced :“update_initramfs=no” to prevent the error.
I’m planning to install gnome desktop ontop, hope I can run a decent mini PC 🙂
From now I forced: “update_initramfs=no”
still investigating load modules problem.
I’m planning to install gnome desktop on top, hope I have a decent mini PC 🙂
Hi Joan,
Can you share how you force “update_initramfs=no”?
Thanks.
I finally solved the load modules problem by commenting “ib_iser” at /lib/modules-load.d/open-iscsi.conf
Thanks Joan, this has been resolved in the upcoming v2 release thank to your post!
Thanks for making the build, I would love someway to subscribe to this page, I keep missing new updates!