This repository provides a pre-installed Ubuntu 22.04 desktop/server image for the Orange Pi 5, offering a default Ubuntu experience. With this port, you can experience the power and stability of Ubuntu on your Orange Pi 5, making it an excellent choice for a wide range of projects and applications.
This device is still new and undergoing continuous development. As a result, you may encounter bugs or missing features. I'll do my best to update this project with the most recent changes and fixes. If you find problems, please report them in the issues section, and I will be happy to assist!
- Package management via apt using the official Ubuntu repositories
- Uses the 5.10.110 Linux kernel built with arm64 flags
- Boot from an SD Card, USB, or NVMe SSD
- 3D video hardware acceleration support via panfork
- Fully working GNOME desktop using wayland
- Chromium browser with smooth 4k video playback
- MPV video player capable of smooth 4k video playback
- Gstreamer can be used as an alternative 4k video player from the command line
- Working Bluetooth and WiFi from the Orange Pi5 PCIe WiFi 6.0 module (AP6275P)
- On board Microphone
- Audio over HDMI
Make sure you use a good, reliable, and fast SD card. For example, suppose you encounter boot or stability troubles. Most of the time, this is due to either an insufficient power supply or related to your SD card (bad card, bad card reader, something went wrong when burning the image, or the card is too slow).
Download your preferred version of Ubuntu from the latest release on GitHub. Then write the xz compressed image to your SD card using balenaEtcher since, unlike other tools, it can validate burning results, saving you from corrupted SD card contents.
Insert your SD card into the slot on the board and power on the device. The first boot may take up to two minutes, so please be patient.
You will be able to login through HDMI or a serial console connection.
There are two predefined users: ubuntu and root. The password for each is root.
Ubuntu 22.04.1 TLS orange-pi5 tty1
orange-pi5 login: root
Password: root
To to set up the build environment, please use a Ubuntu 22.04 machine, then install the below packages:
sudo apt-get install -y build-essential gcc-aarch64-linux-gnu bison \
qemu-user-static qemu-system-arm qemu-efi u-boot-tools binfmt-support \
debootstrap flex libssl-dev bc rsync kmod cpio xz-utils fakeroot parted \
udev dosfstools uuid-runtime git-lfs device-tree-compiler python2 python3 \
python-is-python3
To checkout the source and build:
git clone https://github.com/Joshua-Riek/ubuntu-orange-pi5.git
cd ubuntu-orange-pi5
sudo ./build.sh
- A number of packages are installed and held to enable hardware acceleration. So please don't remove them and re-install with apt-get.