[Detector Support]: Hailo8 version mismatch

[jshepard2007]

Describe the problem you are having

Tried installing v0.16.0-rc4 on my raspberry pi 5. I used the install script mention in the release notes to install the v4.21.0 drivers. Everything said it install fine, rebooted the raspberry pi and could see hailo8 under /dev directory. When I start frigate I get the error message "frigate.detectors.plugins.hailo8l ERROR : Inference error: [HailoRT] [error] CHECK failed - Driver version (4.20.0) is different from library version (4.21.0)" followed by some python errors. The frigate container continually restarts.

Version

0.16.0-rc4

Frigate config file

N/A

docker-compose file or Docker CLI command

services:
    frigate:
        container_name: frigate
        privileged: true
        restart: unless-stopped
        image: ghcr.io/blakeblackshear/frigate:0.16.0-rc4
        shm_size: 3096mb
        devices:
            - /dev/hailo0:/dev/hailo0
        volumes:
            - /etc/localtime:/etc/localtime:ro
            - /opt/frigate/config/:/config
            - /opt/frigate/data/db/:/data/db
            - /mnt/nas/:/media/frigate
            - type: tmpfs
              target: /tmp/cache
              tmpfs:
                size: 1g
        ports:
            - 5000:5000

Relevant Frigate log output

2025-08-15 18:22:55.504003331  [2025-08-15 18:22:55] frigate.detectors.plugins.hailo8l ERROR   : Inference error: [HailoRT] [error] CHECK failed - Driver version (4.20.0) is different from library version (4.21.0)
2025-08-15 18:22:55.504010794  [HailoRT] [error] Driver version mismatch, status HAILO_INVALID_DRIVER_VERSION(76)
2025-08-15 18:22:55.504013220  [HailoRT] [error] CHECK_SUCCESS failed with status=HAILO_INVALID_DRIVER_VERSION(76)
2025-08-15 18:22:55.504017609  [HailoRT] [error] CHECK_SUCCESS failed with status=HAILO_INVALID_DRIVER_VERSION(76)
2025-08-15 18:22:55.504019220  [HailoRT] [error] CHECK_SUCCESS failed with status=HAILO_INVALID_DRIVER_VERSION(76)
2025-08-15 18:22:55.504021498  [HailoRT CLI] [error] CHECK_SUCCESS failed with status=HAILO_INVALID_DRIVER_VERSION(76)
2025-08-15 18:22:55.504022146
2025-08-15 18:22:55.749468994  [2025-08-15 18:22:55] frigate.api.fastapi_app        INFO    : Starting FastAPI app
2025-08-15 18:22:56.093564073  [HailoRT] [error] CHECK failed - Driver version (4.20.0) is different from library version (4.21.0)
2025-08-15 18:22:56.093607795  [HailoRT] [error] Driver version mismatch, status HAILO_INVALID_DRIVER_VERSION(76)
2025-08-15 18:22:56.093625481  [HailoRT] [error] CHECK_SUCCESS failed with status=HAILO_INVALID_DRIVER_VERSION(76)
2025-08-15 18:22:56.126557897  [HailoRT] [error] CHECK_SUCCESS failed with status=HAILO_INVALID_DRIVER_VERSION(76)
2025-08-15 18:22:56.126589786  [HailoRT] [error] CHECK_SUCCESS failed with status=HAILO_INVALID_DRIVER_VERSION(76)
2025-08-15 18:22:56.126611434  [HailoRT] [error] CHECK_SUCCESS failed with status=HAILO_INVALID_DRIVER_VERSION(76)
2025-08-15 18:22:56.126640934  [HailoRT] [error] CHECK_SUCCESS failed with status=HAILO_INVALID_DRIVER_VERSION(76)
2025-08-15 18:22:56.126660638  [HailoRT] [error] CHECK_SUCCESS failed with status=HAILO_INVALID_DRIVER_VERSION(76)
2025-08-15 18:22:56.126677286  [HailoRT] [error] CHECK_SUCCESS failed with status=HAILO_INVALID_DRIVER_VERSION(76)
2025-08-15 18:22:56.126702360  [HailoRT] [error] CHECK_SUCCESS failed with status=HAILO_INVALID_DRIVER_VERSION(76)
2025-08-15 18:22:56.128435178  [2025-08-15 18:22:56] frigate.detectors.plugins.hailo8l ERROR   : [INIT] Failed to initialize HailoAsyncInference: libhailort failed with error: 76 (HAILO_INVALID_DRIVER_VERSION)
2025-08-15 18:22:56.131764738  Process detector:hailo8l:
2025-08-15 18:22:56.131769627  Traceback (most recent call last):
2025-08-15 18:22:56.131771330    File "/usr/local/lib/python3.11/dist-packages/hailo_platform/pyhailort/pyhailort.py", line 3540, in _open_vdevice
2025-08-15 18:22:56.131772627      self._vdevice = _pyhailort.VDevice.create(self._params, device_ids)
2025-08-15 18:22:56.131773775                      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2025-08-15 18:22:56.131774830  hailo_platform.pyhailort._pyhailort.HailoRTStatusException: 76
2025-08-15 18:22:56.131775405
2025-08-15 18:22:56.131776534  The above exception was the direct cause of the following exception:
2025-08-15 18:22:56.131777145
2025-08-15 18:22:56.131777979  Traceback (most recent call last):
2025-08-15 18:22:56.131779164    File "/usr/lib/python3.11/multiprocessing/process.py", line 314, in _bootstrap
2025-08-15 18:22:56.131783701      self.run()
2025-08-15 18:22:56.131784831    File "/opt/frigate/frigate/util/process.py", line 41, in run_wrapper
2025-08-15 18:22:56.131785775      return run(*args, **kwargs)
2025-08-15 18:22:56.131786608             ^^^^^^^^^^^^^^^^^^^^
2025-08-15 18:22:56.131787719    File "/usr/lib/python3.11/multiprocessing/process.py", line 108, in run
2025-08-15 18:22:56.131789682      self._target(*self._args, **self._kwargs)
2025-08-15 18:22:56.131790849    File "/opt/frigate/frigate/object_detection/base.py", line 112, in run_detector
2025-08-15 18:22:56.131792071      object_detector = LocalObjectDetector(detector_config=detector_config)
2025-08-15 18:22:56.131793201                        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2025-08-15 18:22:56.131794405    File "/opt/frigate/frigate/object_detection/base.py", line 57, in __init__
2025-08-15 18:22:56.131795479      self.detect_api = create_detector(detector_config)
2025-08-15 18:22:56.131796442                        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2025-08-15 18:22:56.131817516    File "/opt/frigate/frigate/detectors/__init__.py", line 18, in create_detector
2025-08-15 18:22:56.131818497      return api(detector_config)
2025-08-15 18:22:56.131819331             ^^^^^^^^^^^^^^^^^^^^
2025-08-15 18:22:56.131820479    File "/opt/frigate/frigate/detectors/plugins/hailo8l.py", line 256, in __init__
2025-08-15 18:22:56.131821497      self.inference_engine = HailoAsyncInference(
2025-08-15 18:22:56.131822442                              ^^^^^^^^^^^^^^^^^^^^
2025-08-15 18:22:56.131823608    File "/opt/frigate/frigate/detectors/plugins/hailo8l.py", line 113, in __init__
2025-08-15 18:22:56.131824442      self.target = VDevice(params)
2025-08-15 18:22:56.131834849                    ^^^^^^^^^^^^^^^
2025-08-15 18:22:56.131836275    File "/usr/local/lib/python3.11/dist-packages/hailo_platform/pyhailort/pyhailort.py", line 3533, in __init__
2025-08-15 18:22:56.131837034      self._open_vdevice()
2025-08-15 18:22:56.131838479    File "/usr/local/lib/python3.11/dist-packages/hailo_platform/pyhailort/pyhailort.py", line 3538, in _open_vdevice
2025-08-15 18:22:56.131839405      with ExceptionWrapper():
2025-08-15 18:22:56.131840794    File "/usr/local/lib/python3.11/dist-packages/hailo_platform/pyhailort/pyhailort.py", line 122, in __exit__
2025-08-15 18:22:56.131841831      self._raise_indicative_status_exception(value)
2025-08-15 18:22:56.131843442    File "/usr/local/lib/python3.11/dist-packages/hailo_platform/pyhailort/pyhailort.py", line 172, in _raise_indicative_status_exception
2025-08-15 18:22:56.131844719      raise self.create_exception_from_status(error_code) from libhailort_exception
2025-08-15 18:22:56.131846219  hailo_platform.pyhailort.pyhailort.HailoRTException: libhailort failed with error: 76 (HAILO_INVALID_DRIVER_VERSION)
2025-08-15 18:22:56.138092043  [2025-08-15 18:22:56] frigate.api.fastapi_app        INFO    : FastAPI started
s6-rc: info: service nginx successfully started
s6-rc: info: service certsync: starting
s6-rc: info: service certsync successfully started
s6-rc: info: service legacy-services: starting
2025-08-15 18:22:58.937859025  [INFO] Starting certsync...
s6-rc: info: service legacy-services successfully started
2025-08-15 18:22:59.513795791  127.0.0.1 - - [15/Aug/2025:18:22:59 -0500] "" 400 0 "-" "-" "-"
2025-08-15 18:23:02.155464566  18:23:02.155 WRN [rtsp] error="streams: dial tcp 10.0.1.22:554: i/o timeout" stream=backyard
2025-08-15 18:23:02.160172739  18:23:02.160 WRN [rtsp] error="streams: dial tcp 10.0.1.22:554: i/o timeout, exec/pipe: EOF\n[rtsp @ 0x55557f302540] method DESCRIBE failed: 404 Not Found\nrtsp://127.0.0.1:8554/backyard?audio&source=ffmpeg:backyard%23audio%3Daac: Server returned 404 Not Found\n" stream=backyard
2025-08-15 18:23:02.203326481  18:23:02.203 WRN [rtsp] error="streams: dial tcp 10.0.1.22:554: i/o timeout" stream=backyard_sub
2025-08-15 18:23:02.208009117  18:23:02.207 WRN [rtsp] error="streams: dial tcp 10.0.1.22:554: i/o timeout, exec/pipe: EOF\n[rtsp @ 0x5555b8b52540] method DESCRIBE failed: 404 Not Found\nrtsp://127.0.0.1:8554/backyard_sub?audio&source=ffmpeg:backyard_sub%23audio%3Daac: Server returned 404 Not Found\n" stream=backyard_sub
2025-08-15 18:23:02.213484624  [2025-08-15 18:23:02] frigate.video                  ERROR   : by_backyard: Unable to read frames from ffmpeg process.
2025-08-15 18:23:02.213836347  [2025-08-15 18:23:02] frigate.video                  ERROR   : by_backyard: ffmpeg process is not running. exiting capture thread...
2025-08-15 18:23:15.532417980  [2025-08-15 18:23:15] watchdog.by_backyard           ERROR   : Ffmpeg process crashed unexpectedly for by_backyard.
2025-08-15 18:23:15.532824036  [2025-08-15 18:23:15] watchdog.by_backyard           ERROR   : The following ffmpeg logs include the last 100 lines prior to exit.
2025-08-15 18:23:15.533171796  [2025-08-15 18:23:15] ffmpeg.by_backyard.detect      ERROR   : [rtsp @ 0x55568a7ca640] method DESCRIBE failed: 404 Not Found
2025-08-15 18:23:15.533525648  [2025-08-15 18:23:15] ffmpeg.by_backyard.detect      ERROR   : rtsp://127.0.0.1:8554/backyard_sub: Server returned 404 Not Found
2025-08-15 18:23:15.533769315  [2025-08-15 18:23:15] watchdog.by_backyard           INFO    : Restarting ffmpeg...
2025-08-15 18:23:15.535986262  [2025-08-15 18:23:15] ffmpeg.by_backyard.record      ERROR   : [rtsp @ 0x55563d4b2670] method DESCRIBE failed: 404 Not Found
2025-08-15 18:23:15.536482430  [2025-08-15 18:23:15] ffmpeg.by_backyard.record      ERROR   : rtsp://127.0.0.1:8554/backyard: Server returned 404 Not Found
2025-08-15 18:23:15.536897097  [2025-08-15 18:23:15] watchdog.by_backyard           INFO    : Terminating the existing ffmpeg process...
2025-08-15 18:23:15.537257171  [2025-08-15 18:23:15] watchdog.by_backyard           INFO    : Waiting for ffmpeg to exit gracefully...
2025-08-15 18:23:15.732319641  [2025-08-15 18:23:15] frigate.watchdog               INFO    : Detection appears to have stopped. Exiting Frigate...
s6-rc: info: service legacy-services: stopping
s6-rc: info: service legacy-services successfully stopped
s6-rc: info: service go2rtc-healthcheck: stopping
s6-rc: info: service certsync: stopping
2025-08-15 18:23:15.745764860  [INFO] The go2rtc-healthcheck service exited with code 256 (by signal 15)
2025-08-15 18:23:15.746939565  [INFO] Service CERTSYNC exited with code 256 (by signal 15)
s6-rc: info: service go2rtc-healthcheck successfully stopped
s6-rc: info: service certsync successfully stopped
s6-rc: info: service nginx: stopping
s6-rc: info: service certsync-log: stopping
s6-rc: info: service certsync-log successfully stopped
2025-08-15 18:23:15.826850437  [INFO] Service NGINX exited with code 0 (by signal 0)
s6-rc: info: service nginx successfully stopped
s6-rc: info: service nginx-log: stopping
s6-rc: info: service frigate: stopping
s6-rc: info: service nginx-log successfully stopped

Install method

Docker Compose

Object Detector

Other

Screenshots of the Frigate UI's System metrics pages

N/A - I can't get to it before the container restarts

Any other information that may be helpful

No response

[inkeep-ai-assistant[bot]]

The error you're encountering is a driver version mismatch between the installed Hailo driver (v4.20.0) and the library version (v4.21.0) that Frigate expects. This is a known issue with Hailo8L installations.

For Hailo-8L installation on Raspberry Pi 5, you need to follow the proper installation steps. First, install the driver from the Hailo GitHub repository(1). For Raspberry Pi 5 users with the AI Kit, installation should be straightforward by following the official guide(1).

For other installations, these steps are required(1):

1. Install the driver from the Hailo GitHub repository(1)
2. Copy or download the installation script(1)
3. Ensure it has execution permissions with sudo chmod +x user_installation.sh(1)
4. Run the script with ./user_installation.sh(1)

To set up Frigate, you should use a Docker image with the -h8l suffix, for example: ghcr.io/blakeblackshear/frigate:stable-h8l(1).

Next, grant Docker permissions to access your hardware by adding the following lines to your docker-compose.yml file(1):

devices:  
 - /dev/hailo0  

(1)

If you are using docker run, add this option to your command --device /dev/hailo0(1).

Based on community reports, the solution involves ensuring the driver and library versions match. Users have resolved similar version mismatches by modifying the installation script to use the correct version number and rebuilding the driver(2)(3).

📚 Sources:

1. Installation
2. [Detector Support]: Driver version (4.20.0) is different from library version (4.19.0)
3. [Detector Support]: Frigate v0.15.1 not support Hailo8L firmware 4.20.0

---

Have another question? Just tag @inkeep.