Overview
This repository provides a pre-installed Ubuntu 22.04 desktop/server image for the Orange Pi 5 and 5B, 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. For additional information, please take a look at the documentation available on the Wiki.
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!
Highlights
- Package management via apt using the official Ubuntu repositories
- Receive kernel, firmware, and bootloader updates through apt
- Desktop first-run wizard for user setup and configuration
- 3D video hardware acceleration support via panfork
- Fully working GNOME desktop using wayland
- Chromium browser with smooth 4k youtube 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
- Boot from SD Card, USB, NVMe or SATA SSD
- Working Bluetooth and WiFi from the Orange Pi5 PCIe WiFi 6.0 module (AP6275P)
- Uses the 5.10.110 Linux kernel
- Audio over HDMI
Prepare an SD Card
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.
Boot the System
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.
Login Information
For the server image you will be able to login through HDMI or a serial console connection. The predefined user is ubuntu and the password is ubuntu.
For the desktop image you must connect through HDMI and follow the setup-wizard.
Build Requirements
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 fdisk
Building
To checkout the source and build:
git clone https://github.com/Joshua-Riek/ubuntu-orange-pi5.git
cd ubuntu-orange-pi5
sudo ./build.sh --board=orangepi5
Known Limitations
- The Vulkan graphics API is not supported due to driver limitations.