Installer Frigate NVR sur Raspberry Pi 5 en 2026 : le guide complet

Dans ce tutoriel, nous allons installer Frigate NVR sur un Raspberry Pi 5 pour surveiller efficacement votre maison ou entreprise. Le logiciel Frigate NVR est une solution open source qui permet non seulement d’enregistrer et de stocker les flux vidéo des caméras IP, mais aussi d’appliquer diverses méthodes de surveillance automatique comme la détection des mouvements et l’apprentissage facial. En suivant ce guide, vous configurerez le système d’exploitation Raspbian sur votre Raspberry Pi 5, installerez Docker et Docker Compose pour gérer Frigate NVR, et mettez en place les paramètres de la caméra IP.

Prérequis

• Système d’exploitation : Raspbian Buster ou Bullseye
• Matériel minimum : Raspberry Pi 5 avec au moins 4 Go de RAM (8 Go recommandé)
• Stockage : microSD ou SSD NVMe suffisamment rapide et assez grand pour accueillir les fichiers d’enregistrement vidéo de la caméra.
• Caméra IP : Supporte une grande variété de caméras IP, vérifiez que la vôtre est compatible (Reolink RLC-810A, Dahua IPC-HDW3849HP-AS-PV, etc.)
• Ports réseau : Port 8123 pour l’interface web de Frigate NVR

Installation pas à pas

Étape 1 : Préparer le Raspberry Pi 5

1. Téléchargez et installez Raspbian Buster ou Bullseye sur votre carte microSD ou SSD NVMe.
2. Connectez-vous à votre Raspberry Pi via SSH avec ssh pi@raspberrypi.local (ou l’adresse IP de votre choix).
3. Mise à jour du système : sudo apt-get update && sudo apt-get upgrade -y

Étape 2 : Installer Docker et Docker Compose

1. Ajoutez les dépôts Docker dans /etc/apt/sources.list.d/docker.list:

echo "deb [arch=amd64] https://download.docker.com/linux/debian buster stable" | sudo tee /etc/apt/sources.list.d/docker.list

2. Installez Docker et Docker Compose : sudo apt-get install docker-ce docker-compose -y
3. Vérifiez l’installation avec docker --version et docker-compose --version

Étape 3 : Configurer le dossier de travail pour Frigate NVR

1. Créez un dossier pour votre projet sur le Raspberry Pi : mkdir ~/frigate && cd ~/frigate
2. Initialisez le répertoire pour Docker Compose : docker-compose init (s’il n’est pas déjà installé)
3. Créez un fichier docker-compose.yml avec la configuration de base pour Frigate NVR:

version: '3.8'
services:
frigate:
image: linuxserver/frigate
container_name: frigate
volumes:
- ~/frigate/config:/config
- /dev/gpiomem:/dev/gpiomem
ports:
- 5000:5000/tcp
- 8123:8123/tcp
environment:
...

4. Vérifiez que docker-compose up lance sans erreurs et que le service est en cours d’exécution avec docker ps

Étape 4 : Configurer les paramètres de la caméra IP

1. Ajoutez la configuration de votre caméra dans un fichier YAML, par exemple config/cameras.yml:

cameras:
camera01:
enable: true
still_image_url: 'http://<CAMERA_IP>/snapshot'
record_on_motion: true
...

2. Mettez à jour le fichier docker-compose.yml pour inclure la configuration de votre caméra IP dans l’environnement de Frigate NVR.
3. Relancez Docker Compose avec docker-compose up -d et vérifiez que la caméra est reconnue par Frigate.

Vérifications

Pour tester que tout fonctionne correctement, exécutez les commandes suivantes sur votre Raspberry Pi:

# Vérifier le statut des services Docker
sudo systemctl status docker.service

# Afficher les containers Docker actifs
docker ps -a

# Accédez à l'interface web de Frigate NVR : http://raspberrypi.local:8123/

Si vous voyez le flux vidéo en direct et que la caméra est détectée, votre installation est réussie.

Sécurité et bonnes pratiques

Pour sécuriser votre installation de Frigate NVR:

• Utilisez HTTPS pour l’interface web avec un certificat Let’s Encrypt via Caddy.
• Créez des mots de passe forts et utilisez une authentification à deux facteurs si possible.
• Mettez régulièrement à jour Docker, Docker Compose et Frigate NVR pour bénéficier des dernières améliorations et des correctifs de sécurité.

Dépannage : erreurs courantes

Symptôme: docker ps n’affiche aucun service actif. Cause: Un problème dans le fichier docker-compose.yml ou une erreur lors du démarrage initial. Correctif: Vérifiez les logs avec docker logs frigate, corrigez la configuration et relancez Docker Compose avec docker-compose up -d.

Erreur : La caméra n’est pas détectée

Symptôme: Le flux vidéo est noir ou l’interface web ne montre pas de caméra. Cause: Les paramètres de la caméra dans le fichier YAML sont incorrects ou manquants. Correctif: Vérifiez les URL, clés API et configurations spécifiques à votre modèle de caméra. Relancez Docker Compose après avoir corrigé.

Erreur : La détection des mouvements est inexacte

Symptôme: Les détections de mouvement ne sont pas précises ou trop fréquentes. Cause: Les paramètres de détection dans le fichier YAML ne sont pas optimisés pour votre environnement. Correctif: Modifiez les seuils de sensibilité, la taille des fenêtres de détection et les règles de comportement pour améliorer l’exactitude.

FAQ

La caméra n’est-elle pas compatible avec Frigate NVR ?

Assurez-vous que votre caméra supporte le protocole ONVIF ou a des fonctions API qui peuvent être utilisées par Frigate. Pour les caméras non listées, vérifiez la documentation officielle et les forums de discussion pour obtenir des informations complémentaires.

Comment puis-je sécuriser davantage ma configuration Docker ?

Utilisez des groupes d’utilisateurs limités pour les conteneurs avec docker-compose.yml. Limitez également les ports accessibles au minimum nécessaire. Utilisez un pare-feu réseau pour filtrer les trafic entrant et sortant.

Quels sont les avantages de l’utilisation d’un SSD NVMe sur le Raspberry Pi 5 ?

Un SSD NVMe offre des vitesses beaucoup plus rapides pour la lecture/écriture, ce qui est bénéfique lorsque vous enregistrez des flux vidéo haute définition. Il réduit également le temps de démarrage du système et améliore les performances globales.

A lire aussi

• Booter un raspberry pi 5 sur ssd nvme
• Creer un nas avec un raspberry pi
• Benchmark raspberry pi 5 vs mini pc n100