Frigate + Google Coral avec Home Assistant en 2026

Dans ce tutoriel, nous allons installer et configurer Frigate avec un dongle Google Coral pour la détection d’objets dans Home Assistant. Cette solution permet de surveiller votre homelab ou maison de manière intelligente en reconnaissant les objets présents dans vos flux vidéos. Nous allons couvrir tous les aspects, du déploiement initial à l’intégration avec Home Assistant et la configuration des paramètres d’optimisation.

Prérequis

OS : Ubuntu 24.04 ou Debian 12
Matériel minimal : CPU quad-core, RAM de 8GB minimum, NAS ou mini-PC capable de prendre en charge Docker.
Nom de domaine et configuration DNS pour accéder à Home Assistant depuis l’extérieur (facultatif)
Ports ouverts : port 8123 pour Home Assistant et ports nécessaires aux services Docker
Versions logicielles : Docker v20.10+

Installation pas à pas

Étape 1 : Préparer le système pour Docker et Frigate

Installez Docker sur votre système en suivant la documentation officielle. Assurez-vous que Docker est démarré automatiquement à chaque redémarrage du système.

docker --version # Vérifiez que Docker est installé correctement

Étape 2 : Installer Home Assistant

Créez un répertoire pour votre installation Home Assistant et initialisez-la avec Docker.

mkdir -p /opt/homeassistant && cd $_
docker run -d --name home-assistant --net=host -v /etc/localtime:/etc/localtime:ro -v /path/to/config/:/config -e "TZ=$(cat /etc/timezone)" homeassistant/raspberrypi4-64-homeassistant:latest

Étape 3 : Installer Frigate pour la détection d’objets

Créez un répertoire pour votre installation Frigate et installez-le avec Docker.

mkdir -p /opt/frigate && cd $_
docker run --name frigate -v /path/to/config:/config -e FRIGATE_NAS_USER=frigateuser -e TZ=$(cat /etc/timezone) -e NVIDIA_VISIBLE_DEVICES=all -e NVIDIA_DRIVER_CAPABILITIES=compute,video -v /dev/bus/usb:/dev/bus/usb:ro -p 5001-5002:5001-5002/tcp -it --device=/dev/video0 --cap-add=SYS_ADMIN --restart unless-stopped ghcr.io/blakeblackshear/frigate:latest

Étape 4 : Configurer Frigate pour utiliser Google Coral

Configurez la section ‘cameras’ de votre fichier docker-compose.yml pour spécifier l’utilisation du dongle Google Coral.

cameras:
 - name: camera1
 source: rtsp://username:password@camera_ip/stream
 ffmpeg_args:
 - '-f mjpeg'
 - "-i http://localhost:8080/?action=stream&channel=1&stream_type=mjpeg"
 - '-c:v copy'
 still_image_url: http://localhost:8080/capture

Étape 5 : Intégrer Frigate dans Home Assistant

Ajoutez la plateforme Frigate à votre fichier configuration.yaml de Home Assistant pour l’intégration.

frigate:
 url: http://localhost:5001
 api_key: your_api_key_here

Étape 6 : Optimiser et sécuriser la configuration

Assurez-vous d’optimiser les paramètres de détection et de stockage des images dans Frigate. Utilisez HTTPS pour sécuriser votre installation Home Assistant.

# Exemple de configuration HTTPS avec Caddyfile
http://homeassistant:8123 {
 reverse_proxy homeassistant:8123 {tls}
}

Vérifications

Vérifiez que tous les services Docker sont en cours d’exécution et bien configurés.

docker ps

Assurez-vous de consulter les logs des services pour vérifier qu’il n’y a pas d’erreurs.

docker logs frigate

Sécurité et bonnes pratiques

Utilisez HTTPS avec un certificat Let’s Encrypt pour sécuriser votre installation Home Assistant. Configurez la protection par mot de passe et activez deux facteurs d’authentification (2FA) si possible. Effectuez régulièrement des sauvegardes de vos configurations Docker, Home Assistant et Frigate.

Dépannage : erreurs courantes

Symptôme : Home Assistant ne trouve pas la plateforme Frigate Cause : La configuration YAML n’est pas correcte ou le service Frigate est arrêté Correctif : Vérifiez que les configurations YAML sont bien écrites et relancez les services nécessaires.
Symptôme : Les images de détection ne sont pas stockées Cause : Le dossier de stockage n’est pas correctement configuré ou le service a des problèmes d’accès Correctif : Vérifiez que les chemins dans votre fichier docker-compose.yml pointent vers des répertoires existants et accessibles.
Symptôme : Les performances sont limitées par rapport aux attentes Cause : Le matériel utilisé est sous-optimal pour le traitement en temps réel Correctif : Optimisez vos flux vidéo ou utilisez un matériel plus puissant comme une carte graphique dédiée.

FAQ

La configuration YAML de Frigate semble trop complexe ?

Commencez par suivre les tutoriels et exemples fournis sur le site officiel de Frigate. Vous pouvez également réduire la résolution des flux vidéo pour améliorer les performances.

Peut-on utiliser d’autres dongles hardware que Google Coral ?

Bien qu’il soit conseillé d’utiliser Google Coral, vous pouvez essayer d’autres solutions matérielles compatibles avec Docker et les bibliothèques Tensorflow. Vérifiez la documentation de Frigate pour plus d’options.

Est-ce que je peux utiliser cette solution sans Home Assistant ?

Oui, Frigate peut être utilisé indépendamment pour la détection d’objets dans vos flux vidéo, bien qu’intégrer avec Home Assistant offre des avantages significatifs en termes de gestion et d’événements.

A lire aussi

Heberger ce service

Pas envie de gerer le materiel ni la maintenance ? Ce type de service s’auto-heberge sur un VPS manage, pret en quelques minutes. Voir les offres PlanetHoster