administrator/frigate
1
0
Fork 0
mirror of https://github.com/blakeblackshear/frigate.git synced 2026-04-10 00:57:38 +03:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

Update installation.md for Raspberry Pi and Hailo

Browse Source 
Updated Hailo installation instructions to cover both Bookworm and Trixie OS on Raspberry Pi. 


Referenced discussions: #21177, #20621, #20062, #19531
This commit is contained in:
Pops0n 2026-02-04 16:59:18 +01:00 committed by GitHub
parent 21e4b36c7c
commit 0da51b806f
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 32 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
docs/docs/frigate/installation.md
View File

@ -112,42 +112,47 @@ The Hailo-8 and Hailo-8L AI accelerators are available in both M.2 and HAT form
:::warning :::warning
The Raspberry Pi kernel includes an older version of the Hailo driver that is incompatible with Frigate. You **must** follow the installation steps below to install the correct driver version, and you **must** disable the built-in kernel driver as described in step 1. On Raspberry Pi OS **Bookworm**, the kernel includes an older version of the Hailo driver that is incompatible with Frigate. You **must** follow the installation steps below to install the correct driver version, and you **must** disable the built-in kernel driver as described in step 1.
On Raspberry Pi OS **Trixie**, the Hailo driver is no longer shipped with the kernel. It is installed via DKMS, and the conflict described below does not apply. You can simply run the installation script.
::: :::
1. **Disable the built-in Hailo driver (Raspberry Pi only)**: 1. **Disable the built-in Hailo driver (Raspberry Pi Bookworm OS only)**:
:::note :::note
If you are **not** using a Raspberry Pi, skip this step and proceed directly to step 2. If you are **not** using a Raspberry Pi with **Bookworm OS**, skip this step and proceed directly to step 2.
If you are using Raspberry Pi with **Trixie OS**, also skip this step and proceed directly to step 2.
::: :::
If you are using a Raspberry Pi, you need to blacklist the built-in kernel Hailo driver to prevent conflicts. First, check if the driver is currently loaded: First, check if the driver is currently loaded:
```bash ```bash
lsmod | grep hailo lsmod | grep hailo
``` ```
If it shows `hailo_pci`, unload it: If it shows `hailo_pci`, unload it:
```bash ```bash
sudo rmmod hailo_pci sudo modprobe -r hailo_pci
``` ```
Now blacklist the driver to prevent it from loading on boot: Then rename the built-in driver so it can be restored later if needed:
```bash ```bash
echo "blacklist hailo_pci" | sudo tee /etc/modprobe.d/blacklist-hailo_pci.conf sudo mv /lib/modules/$(uname -r)/kernel/drivers/media/pci/hailo/hailo_pci.ko.xz \
/lib/modules/$(uname -r)/kernel/drivers/media/pci/hailo/hailo_pci.ko.xz.bak
``` ```
Update initramfs to ensure the blacklist takes effect: Now refresh the kernel module map so the system recognizes the change:
```bash ```bash
sudo update-initramfs -u sudo depmod -a
``` ```
Reboot your Raspberry Pi: Reboot your Raspberry Pi:
```bash ```bash
@ -160,7 +165,7 @@ The Raspberry Pi kernel includes an older version of the Hailo driver that is in
lsmod | grep hailo lsmod | grep hailo
``` ```
This command should return no results. If it still shows `hailo_pci`, the blacklist did not take effect properly and you may need to check for other Hailo packages installed via apt that are loading the driver. This command should return no results.
2. **Run the installation script**: 2. **Run the installation script**:
@ -212,6 +217,17 @@ The Raspberry Pi kernel includes an older version of the Hailo driver that is in
lsmod | grep hailo_pci lsmod | grep hailo_pci
``` ```
Verify the driver version:
```bash
modinfo hailo_pci | grep version
```
Verify that the firmware was installed correctly:
```bash
ls -l /lib/firmware/hailo/hailo8_fw.bin
#### Setup #### Setup
To set up Frigate, follow the default installation instructions, for example: `ghcr.io/blakeblackshear/frigate:stable` To set up Frigate, follow the default installation instructions, for example: `ghcr.io/blakeblackshear/frigate:stable`