[Detector Support]: HAILO_DRIVER_NOT_INSTALLED (64)

[sschuetz2bit]

Describe the problem you are having

I am trying to use a Raspberry Pi AI HAT+ (Hailo-8L) with Frigate on Home Assistant OS.
Frigate detects the Hailo backend, but initialization fails with:
HAILO_DRIVER_NOT_INSTALLED (64)

Environment

• Hardware: Raspberry Pi 5 (8 GB)
• Accelerator: Raspberry Pi AI HAT+ (Hailo-8L, PCIe)
• Installation method: Home Assistant OS (HAOS)
• HAOS version: 16.3
• Home Assistant Core: 2025.12.4
• Supervisor: 2025.12.3
• Frigate Add-on version: 0.16.3-9034454
• Architecture: aarch64

Version

0.16.3-9034454

Frigate config file

detectors:
  hailo:
    type: hailo8l
    device: /dev/hailo0
    model:
      path: /config/models/hailo/yolov6n.hef

docker-compose file or Docker CLI command

-

Relevant Frigate log output

hailo_platform.pyhailort.pyhailort.HailoRTException:
libhailort failed with error: 64 (HAILO_DRIVER_NOT_INSTALLED)

Install method

Home Assistant Add-on

Object Detector

Other

Screenshots of the Frigate UI's System metrics pages

Any other information that may be helpful

No response

[inkeep-ai-assistant[bot]]

\The error HAILO_DRIVER_NOT_INSTALLED (64) indicates that the Hailo driver is not properly installed on your Home Assistant OS system(1).

When using Home Assistant OS, the Hailo driver installation process differs from standard Docker installations. The Hailo-8L requires the driver to be installed at the host OS level, but Home Assistant OS manages this differently than a typical Linux installation(1).

For the Raspberry Pi AI HAT+ (Hailo-8L) on Home Assistant OS:

1. The driver installation script documented in the standard installation guide is designed for standard Linux systems, not Home Assistant OS(1)
2. Home Assistant OS needs to have Hailo driver support built into the OS itself(1)

Based on the sources, users have reported that the /dev/hailo0 device may not appear after following the blacklist step in the installation guide(2). One user found that undoing the blacklist step resolved their issue(2).

The Hailo detector configuration should use type: hailo8l and device: PCIe rather than specifying /dev/hailo0 directly(3). Your configuration should look like:

detectors:
  hailo:
    type: hailo8l
    device: PCIe

model:
  width: 320
  height: 320
  input_tensor: nhwc
  input_pixel_format: rgb
  input_dtype: int
  model_type: yolo-generic
  labelmap_path: /labelmap/coco-80.txt

(3)

Since you're running Home Assistant OS, you may need to wait for HAOS to include proper Hailo driver support, or check if your HAOS version includes the necessary kernel modules for Hailo-8L. The error suggests the driver isn't available to the Frigate container at the kernel level(1)(4).

📚 Sources:

1. Installation
2. Stuck at installation guide: /dev/hailo0 not appearing
3. Supported Hardware
4. [Support]: Frigate restart loops with failure to load Hailo8

---

Have another question? Just tag @inkeep.

[sschuetz2bit]

@inkeep wasnt the driver issue fixed in homeassistant os v16.0?

[inkeep-ai-assistant[bot]]

Based on the available sources, I don't have specific information about Home Assistant OS v16.0 fixing the Hailo driver issue.

The installation documentation notes that on Raspberry Pi, you must disable the built-in kernel Hailo driver to prevent conflicts(1). The process involves blacklisting hailo_pci and running the provided installation script(1).

However, the sources don't explicitly mention whether Home Assistant OS v16.0 resolved driver compatibility issues. The documentation focuses on the general installation steps for Hailo-8L devices(1)(2).

Since you're running Home Assistant OS 16.3 and still encountering the HAILO_DRIVER_NOT_INSTALLED (64) error, the driver may not be properly installed or accessible to the Frigate container. You should verify that:

1. The built-in hailo_pci driver is blacklisted(1)
2. The correct Hailo driver version is installed using the installation script(1)
3. Your Frigate configuration uses device: PCIe rather than /dev/hailo0(2)

For specific information about Home Assistant OS v16.0 driver fixes, you may want to check Home Assistant's release notes or contact their support channels, as this falls outside the scope of Frigate documentation.

📚 Sources:

1. Installation
2. Supported Hardware

---

Have another question? Just tag @inkeep.

[sschuetz2bit]

@inkeep which driver version needs to be installed?

[inkeep-ai-assistant[bot]]

Based on the available sources, the Hailo driver version is built into the Frigate Docker image and is not user-configurable(1). The HailoRT driver version included in Frigate must match the driver version installed on your system(2).

The installation script provided in the documentation will install the correct driver version that matches the Frigate image you're using(3). When you run the installation script from the documentation, it will:

1. Clone and build the Hailo driver from the official repository
2. Install the driver
3. Download and install the required firmware
4. Set up udev rules(3)

The specific driver version depends on which Frigate image you're using. Users have reported version mismatches when the system driver doesn't match the library version in the Frigate container(2). For example, one user encountered an error where "Driver version (4.20.0) is different from library version (4.19.0)"(2).

For Home Assistant OS users specifically, Frigate keeps the Hailo version in line with what Home Assistant OS uses(4). For Raspberry Pi 5 users, Home Assistant Operating System version 16.0 is required, and users need to update the Hailo driver and firmware on their system using the user installation script(5).

To ensure compatibility, run the installation script provided in the documentation:

wget https://raw.githubusercontent.com/blakeblackshear/frigate/dev/docker/hailo8l/user_installation.sh
sudo chmod +x user_installation.sh
./user_installation.sh

(3)

After running the script, reboot your system to load the firmware(3).

📚 Sources:

1. Hailo8 driver version requirement configurable?
2. [Detector Support]: Driver version (4.20.0) is different from library version (4.19.0)
3. Installation
4. Update Hailo driver and firmware to v4.21.0
5. [Detector Support]: Hailo-8l

---

Have another question? Just tag @inkeep.

[NickM-27]

I don't see any reason it would be throwing a not installed error. You're using the default addon and it's fully up to date correct?

[sschuetz2bit]

Hi @NickM-27

Yes the default addon installed via HACS. The frigate full access with protection mode off.

Hardware: Raspberry Pi 5 (8 GB)
Accelerator: Raspberry Pi AI HAT+ (Hailo-8L, PCIe)
Installation method: Home Assistant OS (HAOS)
HAOS version: 16.3
Home Assistant Core: 2025.12.4
Supervisor: 2025.12.3
Frigate Add-on version: 0.16.3-9034454

[NickM-27]

Do you see it in the device list in HA OS?

[sschuetz2bit]

@NickM-27 No i dont see it, also not in the PCIE registry, tried another RPI5, same. Maybe the AI HAT was DOA. i try to get a new one.

[sschuetz2bit]

@NickM-27 tried another one, its not showing in the haos hardware