Pi 5 Ubuntu Flavors Guide
← AutismIT
Overview

The Problem: Only Ubuntu Server and Ubuntu Desktop (GNOME) have official Raspberry Pi images. All other Ubuntu flavors (Cinnamon (Ubuntu Cinnamon), KDE (Kubuntu), Xfce (Xubuntu), MATE (Ubuntu MATE), etc.) don't have Pi images available.


The Solution: This guide shows you how to manually build any Ubuntu flavor by installing Ubuntu Server, then adding the desktop environment packages. It also includes the critical xorg configuration fix needed for Pi 5 GPU detection (undocumented elsewhere), plus optional Kodi setup for media center use.


What you get: Any Ubuntu flavor you want on Pi 5, for whatever your use case may be,I did all of this and wrote this guide with the intention to use it as a bedroom TV controller as it were to replace my roku streaming device with Kodi and sometimes just use it as a desktop I can use from bed with a bluetooth keyboard mouse combo from logitech (k400 Plus).


TL;DR: Install Ubuntu Server NOT DESKTOP LTS version is recommended HIGHLY but not required → Add desktop packages (Cinnamon/KDE/Xfce/MATE/LXQt/Budgie) → Apply critical xorg GPU fix → Working desktop of your preferance → Optionally install Kodi. Takes ~45 minutes.

Hardware Requirements

  • Raspberry Pi 5 (any RAM size, 4GB+ recommended to accommodate these large DEs)
  • NVMe SSD (recommended) or microSD card
  • 5Ax5V USB-C power supply like the official 27w USB-C PSU from Raspberry Pi
  • HDMI (micro) cable and display
  • Keyboard and mouse or use of SSH for setup
  • Optional: Pironman 5 Max case for cooling/OLED/RGB/IR receiver
Choose Your Ubuntu Flavor

Select which desktop environment you want. Only Ubuntu Desktop (GNOME) has an official Pi image. This guide lets you install any of the other flavors by manually adding the desktop packages:


Flavor Desktop RAM Usage Best For Official Image?
Ubuntu Desktop GNOME ~1.2GB Modern, polished experience ✓ Yes
Ubuntu Cinnamon Cinnamon ~800MB Traditional Windows-like UI ✗ No
Kubuntu KDE Plasma ~900MB Highly customizable ✗ No
Xubuntu Xfce ~500MB Lightweight, fast ✗ No
Lubuntu LXQt ~400MB Minimal resources ✗ No
Ubuntu MATE MATE ~600MB Classic GNOME 2 style ✗ No
Ubuntu Budgie Budgie ~700MB Clean, modern ✗ No

Part 1: Initial Installation

STEP 1 Install Ubuntu Server 24.04

You can install Ubuntu Server using either method:


Method 1: Raspberry Pi Imager

Download and install Raspberry Pi Imager

  1. Choose Device: Raspberry Pi 5
  2. Choose OS: Has to be Ubuntu Server LTS is Optional though highly reccomended. For this guide we will use Ubuntu Server 24.04.3 LTS

    Other general-purpose OS → Ubuntu → Ubuntu Server 24.04.3 LTS (64-bit)

  3. Choose Storage: Your NVMe (connected with a USB to M.2 Adapter)/SD card
  4. Customisation:
    • Set hostname
    • Enter capital city of your country, Set time zone (EST/EDT is America/New_York), and keyboard layout
    • Set username and password (you will need to remember both of these)
    • Enter Wifi credentials ((Optional though reccomended if you plan to use wifi for setup)
    • Enable SSH and use password authentication
  5. Write to storage device
  6. Upon completion the storage device should have been ejected but double check
  7. Insert into Pi and boot

Method 2: Pi 5 Network Install

  1. Power on your Pi 5 and Hold shift on your keyboard to begin netboot
  2. If that fails Power on your Pi 5 and hold or hit space to bring up the option to change boot settinsg then hit N for netboot
  3. Connect to network via Ethernet (will not work over Wi-Fi)
  4. The Pi will automatically boot into the network install GUI once it has downloaded it
  5. Under "Choose Device" select Raspberry Pi 5
  6. Under "Choose OS" from the menu Has to be Ubuntu Server LTS is Optional though highly reccomended. For this guide we will use Ubuntu Server 24.04.3 LTS

    Other general-purpose OS → Ubuntu → Ubuntu Server 24.04.3 LTS (64-bit)

  7. Under "Choose Storage" select the disk you would like to write the OS to
  8. Select "NEXT" in the bottom right
  9. Under choose device select Raspberry Pi 5
  10. Under "Use OS Customisation?" select EDIT SETTINGS and you will be on the GENERAL tab
  11. Set hostname by checking the box and typing
  12. Set username and password by checking the box and typing (you will need to remember both of these)
  13. Set locale settings Example: Timezone: America/New_York and Keyboard layout:us
  14. Under the SERVICES Tab check enable SSH and leave password authentication selected
  15. Then in the bottom center select save
  16. You will be brough back to "Use OS Customisation?" select YES
  17. Verify correct drive is selected then select YES
Network install requires an Ethernet internet connection and will download the OS to install without an external computer.

STEP 2 Connect via SSH

Find your Pi's IP address:

  • Check the bottom left corner of the Pi's boot menu/login screen
  • Windows: Use Advanced IP Scanner
  • Windows (winget): Install via command line:
Install Advanced IP Scanner with winget
winget install Famatech.AdvancedIPScanner

Then open Advanced IP Scanner and click "Scan" to find your Pi.


SSH into your Pi (replace with your details)
ssh username@your-pi-ip-address-OR-hostname
Example (replace with your details)
ssh [email protected]

Part 2: System Updates

STEP 3 Update System

Update all packages
sudo apt update && sudo apt upgrade -y
This may take several minutes depending on your internet connection and number of available updates.

Part 3: Install Desktop Environment

STEP 4 Install Ubuntu Cinnamon Desktop

Install Ubuntu Cinnamon
sudo apt install ubuntucinnamon-desktop -y
What This Installs: Cinnamon desktop environment with Ubuntu branding, LightDM display manager, and all GUI components.
Download size: ~1GB | Installed size: ~2.2GB

STEP 4 Install Ubuntu Desktop (GNOME)

Install Ubuntu Desktop
sudo apt install ubuntu-desktop -y
What This Installs: Full GNOME desktop environment with all Ubuntu desktop packages, GDM display manager.
Download size: ~1.5GB | Installed size: ~3GB
Note: This is the heaviest option but provides the most polished experience.

STEP 4 Install Kubuntu Desktop (KDE Plasma)

Install Kubuntu Desktop
sudo apt install kubuntu-desktop -y
What This Installs: KDE Plasma desktop environment with SDDM display manager.
Download size: ~1.3GB | Installed size: ~2.7GB
Note: Highly customizable with modern features. Good balance of features and performance.

STEP 4 Install Xubuntu Desktop (Xfce)

Install Xubuntu Desktop
sudo apt install xubuntu-desktop -y
What This Installs: Xfce desktop environment with LightDM display manager.
Download size: ~800MB | Installed size: ~1.8GB
Note: Lightweight and fast, perfect for media center use. Recommended for 4GB Pi 5.

STEP 4 Install Lubuntu Desktop (LXQt)

Install Lubuntu Desktop
sudo apt install lubuntu-desktop -y
What This Installs: LXQt desktop environment with SDDM display manager.
Download size: ~700MB | Installed size: ~1.5GB
Note: Extremely lightweight. Best for older Pis or maximum performance.

STEP 4 Install Ubuntu MATE Desktop

Install Ubuntu MATE
sudo apt install ubuntu-mate-desktop -y
What This Installs: MATE desktop environment with LightDM display manager.
Download size: ~900MB | Installed size: ~2GB
Note: Classic desktop experience, lightweight and familiar. Great balance.

STEP 4 Install Ubuntu Budgie Desktop

Install Ubuntu Budgie
sudo apt install ubuntu-budgie-desktop -y
What This Installs: Budgie desktop environment with LightDM display manager.
Download size: ~1GB | Installed size: ~2.1GB
Note: Modern, clean interface with good performance.

STEP 5 Install Video Drivers

IMPORTANT: Ubuntu Server doesn't include Raspberry Pi GPU drivers by default. These are required for the desktop to work.
Install X server video drivers
sudo apt install xserver-xorg-video-fbdev xserver-xorg-video-modesetting -y
Install Mesa OpenGL drivers
sudo apt install mesa-utils libgl1-mesa-dri -y
Ensure Pi firmware is installed
sudo apt install linux-firmware-raspi -y

STEP 6 Configure X Server for Pi 5 GPU

CRITICAL FIX: This is the most important step. Without this configuration, X server will fail with "no screens found" error on Pi 5. This issue is not documented anywhere else and was discovered through extensive troubleshooting.
Create xorg config directory
sudo mkdir -p /etc/X11/xorg.conf.d
Create xorg configuration file
sudo nano /etc/X11/xorg.conf.d/20-modesetting.conf

Paste this configuration: (copy the entire block)

Xorg configuration content
Section "Device"
    Identifier "Card1"
    Driver "modesetting"
    Option "kmsdev" "/dev/dri/card1"
    Option "ShadowFB" "false"
EndSection

Section "Screen"
    Identifier "Screen0"
    Device "Card1"
EndSection

Save and exit: Ctrl+X, then Y, then Enter

Why this is needed: Pi 5 has two GPU devices (card0 for V3D/3D rendering, card1 for display). X server defaults to card0, which has no display outputs. This config tells X to use card1 which has the HDMI ports.

Part 4: Install Kodi (Optional)

STEP 7 Install Kodi Media Center

If you want to use your Pi as a media center, install Kodi. Otherwise skip this step.

Install Kodi from Ubuntu repositories
sudo apt install kodi -y
Kodi will be available in the applications menu after desktop login. You can launch it like any other application, or configure it to auto-start.

Part 5: Pironman 5 Max Setup (Optional)

STEP 8 Install Pironman Software (Optional)

If you're using a Pironman 5 Max case:

Clone and install Pironman software
cd ~
git clone -b max https://github.com/sunfounder/pironman5.git --depth 1
cd ~/pironman5
sudo python3 install.py
This enables OLED display, RGB lighting, case fan control, and web dashboard at http://[pi-ip]:34001

STEP 9 Configure CPU Fan (Optional - Pironman Only)

Edit boot configuration
sudo nano /boot/firmware/config.txt

Add these lines at the bottom:

CPU fan configuration (50% speed always-on)
# CPU fan always on at 50%
fan_temp0=0
fan_temp0_speed=50

Save and exit: Ctrl+X, then Y, then Enter

fan_temp0=0 = fan turns on at 0°C (always)
fan_temp0_speed=50 = 50% speed (adjust 0-100 as needed)

Part 6: Final Steps

STEP 10 Reboot

Reboot to apply all changes
sudo reboot
After reboot: You should see the graphical login screen on your monitor. Login with your credentials to access the desktop. Kodi will be in the applications menu.

Troubleshooting

Black Screen / No GUI
Check display manager status
sudo systemctl status lightdm
Check X server logs
sudo cat /var/log/Xorg.0.log | tail -50
Most common issue: Missing xorg configuration. Verify /etc/X11/xorg.conf.d/20-modesetting.conf exists and contains the correct content from Step 6.
Verify GPU Detection
List DRM devices
ls -la /dev/dri/

You should see:

  • card0 → V3D (3D only)
  • card1 → GPU with HDMI outputs (what X needs)
  • renderD128 → Render node
Pironman Issues
Check Pironman service
sudo systemctl status pironman5.service
Restart Pironman service
sudo systemctl restart pironman5.service

Performance & Usage Tips

  • NVMe Boot: Boot from NVMe SSD for much faster performance vs SD card
  • RAM Usage: may be able to get away with 2GB for some DEs but 4GB adequate for most desktop enviorments, 8GB+ for multitasking
  • Cooling: The Pi 5 series is best accompanied by at least the official active cooler, I will be using the Pironman 5 Max which claims to keep temps under 40°C at full load (it also looks cool)
  • Network: Use wired Ethernet for reliability and much larger bandwidth and lower latency
  • Auto-login: Setup varies by Desktop Enviorment but usually you can Configure in System Settings auto login
  • Kodi Auto-start: Add to Startup Applications if you want Kodi to launch on boot
Additional Helpful Services You Can Run

With 8GB+ RAM, you can add services alongside the desktop:

  • Pi-hole: Network-wide ad blocking
  • Plex/Jellyfin: Media server though much better fit for a Mini PC than a Pi due to its lack of transcoding ability and more restrictive IO
  • Docker: Container platform for self-hosting
  • Samba: Network file sharing

Frequently Asked Questions

Can I install Ubuntu Cinnamon directly on Raspberry Pi 5?

No, Ubuntu Cinnamon doesn't have an official Pi image. You must install Ubuntu Server first, then add the Cinnamon desktop packages as shown in this guide.

Can I use this Pi for gaming or RetroPie?

Yes, you can install RetroPie or EmulationStation on top of any Ubuntu desktop. Performance is similar to Raspberry Pi OS.

What if something goes wrong? How do I start over?

Simply reflash your SD card or NVMe with Ubuntu Server and start the guide again. Software changes don't affect hardware - you can reinstall as many times as needed.