215 words
1 minute
Install Hailo-8 on Raspberry Pi 5 Running Ubuntu 24.04

1. Download and Flash Ubuntu#

Download Ubuntu#

Download Ubuntu 24.04 for Raspberry Pi from the Ubuntu image archive.

Scroll down to find the Preinstalled desktop image.

Ubuntu preinstalled desktop image download for Raspberry Pi Generic (64-bit ARM)

Flash the image to a microSD card or SSD using Raspberry Pi Imager or another flashing tool.

Verify Installation#

Terminal window
cat /etc/os-release

Check that the output identifies Ubuntu 24.04 LTS.

2. Enable PCIe Gen3#

Edit the firmware configuration file:

Terminal window
sudo nano /boot/firmware/config.txt

Add the following line:

dtparam=pciex1_gen=3

Reboot the System#

Terminal window
sudo reboot
Terminal window
sudo lspci -vv | grep LnkSta

Look for the following link speed and width:

LnkSta: Speed 8GT/s, Width x1

3. Validate Hardware Detection#

Verify PCIe device detection:

Terminal window
lspci

Example output (the PCIe address may differ):

06:00.0 Co-processor: Hailo Technologies Ltd. Hailo-8 AI Processor

4. Install Dependencies#

Update the System#

Terminal window
sudo apt update
sudo apt full-upgrade -y

Install Required Packages#

Terminal window
sudo apt install -y \
build-essential \
dkms \
linux-headers-$(uname -r)

5. Download and Install Hailo Software and Driver#

Download Packages#

Download the following packages from the Hailo Developer Zone:

  • HailoRT
  • HailoRT PCIe Driver
  • TAPPAS

Hailo Developer Zone software downloads with Hailo-8/8L, HailoRT, ARM64, Linux, and Python 3.12 selected

The commands below install the HailoRT runtime and PCIe driver.

Install the Driver and Runtime#

From the directory containing the downloaded packages, run:

Terminal window
sudo dpkg -i \
hailort_*.deb \
hailort-pcie-driver_*.deb

Resolve Dependencies#

Terminal window
sudo apt -f install

Reboot#

Terminal window
sudo reboot

Ensure that the versions of hailort and hailort-pcie-driver match.

6. Verify Installation#

Verify Firmware Communication#

Terminal window
hailortcli fw-control identify

Verify Driver Version#

Terminal window
modinfo hailo_pci | grep version
Install Hailo-8 on Raspberry Pi 5 Running Ubuntu 24.04
https://blog.hanzogenji.cn/posts/tutorials/install-hailo-8-raspberry-pi-5-ubuntu-24-04/
Author
Hanzo Huang
Published at
2026-10-16