This is a unofficial distribution of Ubuntu Server 18.04.3 for Raspberry Pi 4. It is provided with the purpose of letting us all play with the new Pi 4’s new increased RAM and other capabilities until Ubuntu’s repositories are updated with support for the newest Pi.
Once official support is released through the Ubuntu repositories this project will effectively cease to exist (until, dare I dream, the Pi 5?). The image supports KVM, has support for the Pi 4’s new 3D display driver, and can also be upgraded to a full desktop installation!
I want to also thank all the commenters on my Ubuntu Server Installation Guide for Raspberry Pi 4 who have contributed a ton of fixes to help get the image to the point it is at now! This has truly been a collaborative effort and I expect it will continue to be until official support is released.
- Custom compiled 64-bit kernel based on the rpi-4.19.y source tree
- Preinstalled image contains Ubuntu Server 18.04.3 installation that can be upgraded to a full Ubuntu full desktop installation
- Able to address all memory up to 4 GB of RAM
- 3D driver support via vc4-fkms-v3d and upgraded Mesa version
- KVM enabled
- USB_UAS support enabled
- Fixes for most drivers implemented
GitHub Project Location
The image and source code to build the image are open source and freely available on GitHub:
Update Firmware First (using Raspbian)!
One important new thing to understand about the Raspberry Pi 4 vs. older Pis is that the 4 now has real onboard firmware that is on a special chip separate from everything else. Older Raspberry Pis did not have real onboard firmware and loaded all of their firmware from the SD card every single boot.
Since Ubuntu does not officially even support the Pi 4 yet the Ubuntu repositories do not have firmware compatible with the Pi 4.
Before you install this image you should run Raspbian and install the latest firmware using this command:
sudo apt-get update && sudo apt-get dist-upgrade -y sudo rpi-update
Note that rpi-update will install bleeding edge firmware but since we are running a bleeding edge operating system and cannot receive updates I highly recommend putting the latest possible one you can on before installation.
If you have multiple SD cards or storage devices laying around it is a good idea to designate one of them as the “Official Raspbian Firmware Updater” card. Using this method you can periodically swap out the card and install the latest firmware updates to your Pi 4 and then switch right back to Ubuntu.
Preinstalled Image Download / Instructions
To download the precompiled image see the releases section located at https://github.com/TheRemote/Ubuntu-Server-raspi4-unofficial/releases
The file you are looking for on the releases page is ubuntu-18.04.3-preinstalled-server-arm64+raspi4.img.xz. Download this file and extract the .img file from inside. Use the free and awesome 7-zip if you are on Windows.
Now burn the .img file using your favorite program. I use Win32DiskImager. Now insert your SD card / storage device into the Pi and start it up!
Upon logging in for the first time you will be required to change the default password to something else. Once you have done that log back in and you should be all set!
Install Full Ubuntu Desktop Version
To install the full version of Ubuntu Desktop use one of the following:
- sudo apt-get update && sudo apt-get dist-upgrade && sudo apt-get install xubuntu-desktop # or
- sudo apt-get update && sudo apt-get dist-upgrade && sudo apt-get install kubuntu-desktop
The xubuntu variant is lighter than the kubuntu variant but either one will need to download and install thousands of packages to complete the upgrade. This can obviously take quite a long time. How long it will take depends on your internet connection and the quality of your storage device.
Running this task overnight or when you have an errand to go run is definitely advised!
Firmware & apt Updates
The kernel has been recompiled to enable the Pi 4 specific performance features (as well as features specific to Ubuntu that aren’t used in Raspbian) and the image performance is pretty good now. This will likely continue to improve further as people test the image and find fixes and new firmware patches coming out every few days to address lingering problems/performance issues.
As explained in the update firmware section above, Ubuntu will not update the Pi 4 firmware for you as it is not yet officially supported. Firmware fixes are coming out as often as every couple of days! Make sure you keep your firmware up to date using the methods I outline in the firmware section.
You may use apt-get update && apt-get upgrade and dist-upgrade normally in this image. The only thing it won’t update is the firmware to prevent breaking your installation. All other Ubuntu security patches/updates will appear and install normally just like the official distribution. It’s highly recommended to always keep up to date in apt!
As a reminder the commands are:
sudo apt-get update && sudo apt-get dist-upgrade
Beyond keeping your firmware and distribution up to date there is only one thing that sets apart one Ubuntu installation on a Pi from any other: your storage device. The difference between a low end to high end SD card can be a 2-3x performance, and the difference between a SD card and a solid state drive is a whole order of magnitude.
To help people know whether they have high performance storage I made the Raspberry Pi Storage Benchmark that will give you a performance score. Running the benchmark is really easy. Paste or type the following commands:
wget https://raw.githubusercontent.com/TheRemote/PiBenchmarks/master/Storage.sh chmod +x Storage.sh sudo ./Storage.sh
The storage benchmark will run several well known and respected benchmarks such as iozone and fio and calculate a score for your device.
Most importantly, to compare your score or if you want to just view other benchmark submissions check out the full results of all submissions in a searchable/sortable table at the Raspberry Pi Storage Benchmark Results Page.
Using USB Storage / Solid State Drive (SSD)
Right now the Pi 4 still lacks USB boot support. However, you can still do it by using the trick of having a SD card that you use as a bootloader only and have the rootfs on your USB storage. This is kind of a waste of a SD card but it’s definitely worth it as it allows you to hit those full sweet sweet USB 3.0 transfer speeds right now without waiting until the USB booting firmware update is released.
See my Raspberry Pi 4 USB Booting Guide for more information on how this works and how to set it up.
Known Issues / Fixes
This section will be updated with known issues/fixes as people test the image and give feedback.
Display driver issues (HDMI)
This change is included in v6 and later of the image. Check that your /boot/config.txt file has the following line commented out:
Now reboot the system and the display driver should be functioning normally.
CUPS system module fails to load
This change is automatically integrated in v6 and later of the image but in case the config file got reset here are the instructions.
The default config file for CUPS tries to load a parallel printer driver (which the Pi does not have parallel ports). To fix this we need to edit the CUPS filter config file.
Pre-Release v6 – 9/7/2019
- Updated kernel to rpi-4.19.71
- Integrated all available updates from apt into the base image
- Fixed display driver issue — if you are running v5 you can fix it by commenting out dtoverlay=vc4-fkms-v3d from /boot/config.txt
- Enabled Ceph support in the kernel .config
- Added build flags to kernel build line to build a more complete device tree (dtbo files)
- Integrated all upstream updates since v5 from raspberrypi-linux and firmware-nonfree including a 3D driver fix for aarch64
Pre-Release v5 – 9/3/2019
- Desktop support added
- Expect lots of warnings in the logs. If you find solutions to them please leave a comment — many commits come from the comments!
- Be advised — installing can take quite a while on a Pi — overnight or when you have something to do is a good time
- Type one the following commands to install your preferred flavor of Ubuntu Desktop
- sudo apt-get install xubuntu-desktop # or
- sudo apt-get install kubuntu-desktop
Pre-Release v4 – 9/2/2019
- Recompiled kernel to include support for Ubuntu features that are not present in Raspbian
- Enabled USB UAS support
- Fixed video driver by modifying config.txt and compiling with 3D support
- System now boots clean and loads all modules (sudo systemd status)
Pre-Release v3 – 9/2/2019
- Fixed IPv6 and a few other module load errors
Pre-Release v2 – 8/31/2019
- Boot time reduced from 100s to around 30s
- Messing with apt-mark or flash-kernel is no longer necessary and the fix has been built into the image
- Fixed bluetooth firmware bug that was looking in /etc/firmware instead of /lib/firmware
- Fixed entropy bug causing slow startup
- Fixed mdadm.conf RAID warning
- Module.symvars is now available in /boot/firmware/ if you need it to build kernel modules
If you need the whole source tree check out the accompanying build script in the repository. It’s exactly the same as how the kernel and modules were built.
- Various other fixes (special thanks to Joan at jamesachambers.com for contributing so many)
- More at https://jamesachambers.com/raspberry-pi-ubuntu-server-18-04-2-installation-guide/