Info::Frigate installation
KEYWORDS/ FRIGATE, INSTALLATION, CAMERA
Le 12/10/2026:
Frigate NVR avec Coral USB et caméra Vivotek
Info::frigate:rules le 21/11/2026: règles à ce jour
Résumé
Ce serveur (Debian 13 « trixie », adresse 192.168.1.247) fait tourner Frigate, un enregistreur vidéo (NVR) capable de reconnaître des objets dans l'image. La reconnaissance est accélérée par une clé Google Coral USB. Une caméra Vivotek est raccordée, et les événements sont envoyés à Home Assistant par MQTT, via un broker Mosquitto installé sur ce même serveur.
| Élément | Valeur |
|---|---|
| Serveur | 192.168.1.247 (Debian 13, 4 cœurs, 15 Go de RAM) |
Caméra 1 : vivotek (« Maison des Tracteurs ») |
Vivotek IB8369A, 192.168.1.199 (1080p) |
Caméra 2 : garage |
Reolink TrackMix WiFi « camGarage », 192.168.1.169 (4K), ajoutée le 2026-10-09 |
| Accélérateur | Google Coral USB (branché sur un port USB 3) |
| Dossier d'installation | /opt/frigate/
|
| Interface web | https://frigate.headscale.pcstreet.org:8971 (certificat Let's Encrypt ; l'adresse IP affiche un avertissement) |
| Broker MQTT | 192.168.1.247:1883 (mot de passe obligatoire) |
| E-mails d'alerte | vers pchevalier@apsi.net, via mail.apsi.net (alertes vérifiées, avec photos et vidéo) |
| IA générative | Qwen2.5-VL-7B (images) et gpt-oss-120b (discussion) sur hal (192.168.1.111:8090) |
Ce qui a été fait
1. Vérification du Coral USB
Le Coral a été détecté avec lsusb. Il change d'identifiant selon son état :
| Identifiant USB | Signification |
|---|---|
1a6e:089a Global Unichip Corp. |
Coral non initialisé (après un branchement ou un redémarrage du serveur) |
18d1:9302 Google Inc. |
Coral initialisé : le firmware est chargé et la clé est prête |
Ce changement d'identifiant est normal. Il se produit au premier chargement du firmware par Frigate.
2. Vérification de la caméra
La caméra répond sur les ports 80 (HTTP) et 554 (RTSP). Ses flux sont lisibles sans authentification :
| Flux | URL | Résolution | Utilisation dans Frigate |
|---|---|---|---|
| Principal | rtsp://192.168.1.199:554/live.sdp |
1920×1080, H.264, 25 i/s | Enregistrement |
| Secondaire | rtsp://192.168.1.199:554/live2.sdp |
1280×720, H.264, 25 i/s | Détection (5 i/s) |
3. Installation de Docker
Docker est installé depuis les dépôts Debian :
apt-get install docker.io docker-compose systemctl enable --now docker
4. Installation de Frigate et Mosquitto
Les deux services sont décrits dans /opt/frigate/docker-compose.yml :
- frigate (
ghcr.io/blakeblackshear/frigate:stable) : accès USB pour le Coral, et un espace en mémoire (tmpfs) de 1 Go pour le cache vidéo ; - mosquitto (
eclipse-mosquitto:2) : le broker MQTT, qui refuse les connexions sans mot de passe ; - verificateur (construit depuis
verificateur/) : le vérificateur indépendant des alertes, qui envoie aussi les e-mails (ajouté le 2026-10-09).
Les deux conteneurs redémarrent automatiquement (restart: unless-stopped).
5. Configuration MQTT
- Un compte MQTT
frigatea été créé, avec un mot de passe aléatoire. - Ce compte est stocké dans
/opt/frigate/.env(lisible par root uniquement), puis passé à Frigate sous forme de variables d'environnement (FRIGATE_MQTT_USER/FRIGATE_MQTT_PASSWORD). - Frigate publie sur les sujets
frigate/#. - Les connexions sans mot de passe sont refusées (vérifié).
Organisation des fichiers
/opt/frigate/
├── .git/ , .gitignore # dépôt git (secrets et données exclus)
├── docker-compose.yml # définition des conteneurs frigate + mosquitto
├── .env # identifiants MQTT lus par Frigate (chmod 600)
├── identifiants.txt # récapitulatif des identifiants (chmod 600)
├── changer-mdp-admin.sh # changement du mot de passe d'un utilisateur de l'interface web
├── changer-mdp-mqtt.sh # changement du mot de passe d'un compte MQTT
├── Frigate_installation.wiki # cette documentation : installation
├── .notUsedNow/ # fichiers plus utilisés (anciennes copies .bak, essais, captures de test), chemins d'origine conservés ; liste dans LISEZMOI.txt (depuis le 2026-10-12)
├── Frigate_utilisation.wiki # documentation : utilisation au quotidien
├── education/ # eduquer.sh : apprentissage de Frigate (voir le wiki d'utilisation)
├── sendingAnAlert.sh # VOTRE script, lancé à chaque premier e-mail d'alerte (modèle fourni)
├── declencheur/ # écoute MQTT -> lance sendingAnAlert.sh (service frigate-alerte)
│ ├── ecoute-alertes.sh, frigate-alerte.service (copie de /etc/systemd/system/)
│ └── declencheur.log # journal (hors git)
├── timelapse/ # scripts du time-lapse (capture.sh, timelapse.sh, rattrapage.sh), copies des minuteries ;
│ # « videos » = raccourci vers les vidéos (storage/timelapse/videos, sur srv18)
├── https/ # autorité locale et certificat HTTPS de Frigate (voir « HTTPS »)
│ ├── ca.crt / ca.key # autorité « Autorité Frigate Maison » (ca.key : SECRET, hors git)
│ ├── frigate/ # monté dans le conteneur sur /etc/letsencrypt/live/frigate
│ │ └── fullchain.pem, cert.pem, privkey.pem (privkey : hors git)
│ ├── frigate.cnf # paramètres du certificat (noms et adresses)
│ └── apache-frigate-redirect.conf # copie du site Apache de redirection
├── verificateur/ # vérificateur indépendant des alertes (voir section dédiée)
│ ├── verificateur.py, Dockerfile, test_vlm.py
│ └── data/ # verdicts (verifications.jsonl) + captures des faux positifs (hors git)
├── hal/ # copies de référence des fichiers modifiés sur hal (voir LISEZMOI.txt)
├── travail/ # fichiers de travail : captures de test, vérifications
├── config/
│ ├── config.yml # configuration Frigate
│ └── config.yml.bak-* # sauvegardes avant chaque modification manuelle (les anciennes : .notUsedNow/config/)
├── storage/ # enregistrements, captures, visages : montage NFS de srv18:/data/frigate (depuis le 2026-10-09)
│ ├── recordings/
│ ├── clips/
│ └── exports/
└── mosquitto/
├── config/mosquitto.conf # configuration du broker
├── config/passwd # comptes MQTT (mots de passe chiffrés)
├── data/ # données conservées par le broker
└── log/
Configuration Frigate
Fichier /opt/frigate/config/config.yml :
| Paramètre | Valeur |
|---|---|
| Détecteur | edgetpu sur le Coral USB, modèle YOLOv9-s (yolo-generic, 320×320, 17 classes) depuis le 2026-10-09 à 14:42 : environ 9,2 ms par analyse. Auparavant : SSD MobileNet par défaut, environ 8,3 ms
|
| Flux relayés (go2rtc) | vivotek (flux principal) et vivotek_sub (flux secondaire)
|
| Décodage vidéo | matériel, Intel QSV (hwaccel_args: preset-intel-qsv-h264)
|
| Détection | 1280×720 à 5 i/s |
| Objets suivis | person, car, cat, dog |
| Zone d'inclusion | zone_active (« zone active ») : tout le sol du jardin, tous objets confondus
|
| Masque de mouvement | « zone d'exclusion » : le haut de l'image (arbres, fond du jardin, horodatage) |
| Alertes | person et car, uniquement dans zone_active (review.alerts.required_zones)
|
| Masque d'objet | « objet blanc au fond » : petite remorque blanche au pied de l'arbre, à droite |
Seuil person |
threshold: 0.75 (0,70 par défaut)
|
Seuils dog / cat |
min_score: 0.4, threshold: 0.6 (0,5 / 0,7 par défaut), pour détecter Tommy
|
| Reconnaissance faciale | activée (face_recognition: enabled, model_size: small, sur le processeur), le 2026-10-09
|
| Enregistrement (depuis le 2026-10-10 à 08:50) | Pas d'enregistrement continu ; mouvement : 1 jour (filet de sécurité) ; moments avec un objet suivi (alertes et détections, mode: active_objects) : 30 jours. Identique pour les deux caméras. Voir « Ne garder que l'intéressant »
|
| Passages avec mouvement | 15 jours (record.motion.days)
|
| Alertes / détections | 30 jours (mode: all)
|
| Captures (snapshots) | 14 jours |
| MQTT | hôte mosquitto, port 1883, préfixe frigate
|
Les flux de la caméra passent par go2rtc, un relais intégré à Frigate. La caméra n'a ainsi qu'une seule connexion à fournir par flux, et Frigate peut redistribuer ces flux (sur le port 8554).
Utilisation
L'usage courant (accès à l'interface, commandes, reconnaissance, apprentissage, e-mails, time-lapse) est décrit dans le wiki d'utilisation (Frigate_utilisation.wiki).
Caméra Reolink « garage »
Matériel
| Élément | Valeur |
|---|---|
| Modèle | Reolink TrackMix WiFi (deux objectifs, grand-angle et téléobjectif, suivi automatique), nom « camGarage » |
| Adresse | 192.168.1.169 (MAC ec:71:db:02:5b:ec), en Wi-Fi |
| Firmware | v3.0.0.4255_2411271222 |
| Identifiants | utilisateur admin. Ils se trouvent dans /opt/frigate/.env (FRIGATE_REOLINK_USER / FRIGATE_REOLINK_PASSWORD), hors git. Frigate les insère dans les URL grâce à {FRIGATE_REOLINK_USER}
|
| Ports | HTTP 80, HTTPS 443, RTSP 554, RTMP 1935, ONVIF 8000, média 9000 |
| Heure | NTP pool.ntp.org. Le 2026-10-09, il y avait 1 h de retard : l'heure d'été n'était pas activée. Elle a été activée par l'API (SetTime), avec la règle européenne : du dernier dimanche de mars à 2 h au dernier dimanche d'octobre à 3 h. La règle d'octobre tombait sur le 4ᵉ dimanche
|
Flux
| Chemin RTSP | Objectif | Format | Utilisation |
|---|---|---|---|
h264Preview_01_main |
grand-angle | 3840×2160 H.265, 25 i/s, ~6,2 Mbit/s mesurés | Enregistrement (flux go2rtc garage)
|
h264Preview_01_sub |
grand-angle | 896×512 H.264 | Détection à 5 i/s, et direct par défaut (flux garage_sub)
|
Preview_02_main / Preview_02_sub |
téléobjectif | 1920×1080 H.265 / 896×512 H.264 | non utilisé pour l'instant |
Le direct propose deux choix (live.streams) : « Sous-flux (compatible) », sélectionné par défaut, et « 4K ». Le flux 4K est en H.265, que Firefox lit mal.
Enregistrement et espace disque
Le flux principal ne propose que la 4K, avec un débit d'au moins 4 Mbit/s (choix de 4 à 8 Mbit/s), et réduire les images par seconde ne baisse pas le débit. À 6,2 Mbit/s, cela fait ~67 Go par jour, soit ~470 Go pour 7 jours de continu. C'est impossible sur le disque système (162 Go libres). Même à 4 Mbit/s, 7 jours feraient ~300 Go.
Réglage retenu le 2026-10-09 : pas d'enregistrement continu pour garage, 7 jours de passages avec mouvement (en 4K) et 30 jours d'alertes et de détections. L'occupation réelle dépend de la quantité de mouvement : il faut la surveiller.
Pour enregistrer en continu, deux pistes :
- stockage externe : un disque dédié, ou un partage NFS ou SMB (pas FTP) monté sur
/opt/frigate/storage, par le réseau filaire. La base de Frigate (config/) doit rester locale ; - conversion par Frigate du 4K en 1080p avant l'enregistrement (~1,5 Mbit/s, ~16 Go par jour) : la charge pour le processeur Intel reste à mesurer.
Limite : la reconnaissance faciale
La détection et la reconnaissance faciale se font sur le sous-flux en 896×512, avec un objectif grand-angle. Les visages y sont donc petits. Frigate ne tente de reconnaître un visage qu'à partir de 750 px² (face_recognition.min_area) :
- 12:25, de près (personne de 183×413 px) : 6 tentatives, dont 2 « Patrick » à 0,99 → reconnu ;
- 12:32, plus loin (personne de 71×174 px, visage d'environ 15×18 px) : aucune tentative → non reconnu, mais l'alerte a bien été détectée et confirmée.
Piste : utiliser le téléobjectif (Preview_02), qui suit la personne et cadre son visage en grand.
Suivi automatique de la caméra
La TrackMix pivote toute seule pour suivre ce qui bouge : on le voit le 2026-10-09 à 13:51 (Marie-José) et à 15:07 (arrivée de la VW). Quand la caméra tourne, toute l'image bouge : Frigate voit du mouvement partout, ses masques et zones ne correspondent plus au décor, et le suivi des objets peut décrocher. Le confier à Frigate est impossible (vérifié le 2026-10-09). La connexion ONVIF (cameras.garage.onvif, port 8000) annonce seulement les fonctions pt et zoom, en mouvement continu, sans aucun preset ONVIF. Or le suivi automatique de Frigate exige des déplacements relatifs au champ de vision (pt-r-fov) et l'état du mouvement (MoveStatus), et son zoom exige un zoom relatif ou absolu (zoom-r / zoom-a). Frigate désactive donc son suivi pour cette caméra. L'ONVIF reste configuré : il donne les commandes manuelles (flèches, zoom) dans la vue Direct de garage.
Décision du 2026-10-09 : image fixe. Le suivi automatique de la caméra a été désactivé par son API. Avant : bSmartTrack: 1, aiTrack: 4 (personnes, véhicules, chiens et chats), retour à la position de garde après 42 s. Après : bSmartTrack: 0, aiTrack: 0. La caméra a ensuite été ramenée sur sa position de garde (SetPtzGuard, toPos) : vue sur le saule, l'allée et les poubelles à droite (capture .notUsedNow/travail/garage-position-garde-1521.jpg). Les réglages d'origine sont sauvegardés dans .notUsedNow/travail/reolink-GetAiCfg-avant.json et .notUsedNow/travail/reolink-GetPtzGuard-avant.json.
Outil : travail/reolink-api.sh '[{"cmd":"GetAiCfg","action":0,"param":{"channel":0}}]'. Il ouvre une session, envoie la commande et referme la session. La caméra limite le nombre de sessions : des sessions restées ouvertes donnent l'erreur « please login first ».
# réactiver le suivi de la caméra :
travail/reolink-api.sh '[{"cmd":"SetAiCfg","action":0,"param":{"channel":0,"bSmartTrack":1,"aiTrack":4}}]'
# enregistrer le cadrage actuel comme position de garde :
travail/reolink-api.sh '[{"cmd":"SetPtzGuard","action":0,"param":{"PtzGuard":{"channel":0,"cmdStr":"setPos","bSaveCurrentPos":1}}}]'
Remarque : dans la journée du 2026-10-09, la caméra a changé de cadrage en suivant des personnes (le mur et le climatiseur à 12:25 et 12:32, le saule à 13:51). Cadrage validé par Patrick le 2026-10-09 : on garde la position de garde actuelle (saule, allée, poubelles à droite). Les zones et masques de la Reolink sont à dessiner sur ce cadrage.
Détection
Mêmes objets suivis et mêmes seuils que la Vivotek (person 0,75, dog/cat 0,4 / 0,6), descriptions IA, résumés d'alertes en français, et vérification et e-mails par le vérificateur, qui gère toutes les caméras. Zone garage_cour (la cour au premier plan, sous la ligne des massifs), dessinée par Patrick. Les alertes de la Reolink exigent l'entrée dans cette zone depuis le 2026-10-10 : une personne ou une voiture vue ailleurs (fond du jardin, rue) reste une simple détection, sans e-mail. Masque de mouvement « haut des arbres ». Dans l'interface, la caméra se choisit avec le bouton bleu en haut à droite de Configuration des caméras.
À la mise en service : 5 i/s reçues, connexion « excellente », 8,4 ms par analyse sur le Coral, partagé entre les deux caméras.
Zones et masques
Les trois types de tracés
| Type | Rôle | Usage typique |
|---|---|---|
| Masque de mouvement | Exclusion : Frigate ne cherche plus de mouvement dans cette partie de l'image | Feuillage qui bouge au vent, horodatage, ciel |
| Masque d'objet | Exclusion : un objet dont le bas du cadre de détection tombe dans cette partie est ignoré | Fausse détection à un endroit fixe (une poubelle prise pour une personne…) |
| Zone | Inclusion : délimite une partie de l'image qui intéresse | N'alerter que lorsqu'un objet entre dans l'allée ou par l'entrée |
Dessiner ou modifier
- Paramètres → Masques / Zones, puis choisir la caméra
vivotek. - Cliquer sur Ajouter une zone, Nouveau masque de mouvement ou Ajouter un masque d'objet.
- Cliquer sur l'image pour poser chaque coin, puis fermer la forme en cliquant sur le premier point. Les points se déplacent en les faisant glisser.
- Pour une zone : un nom d'au moins 2 caractères, sans point et différent du nom de la caméra, puis le choix des objets concernés.
- Enregistrer : les zones et masques s'appliquent à chaud, sans redémarrage.
Vérifier
- Paramètres → Débogage : cocher Zones, Masques, Mouvement et Cadres pour voir en direct ce que Frigate utilise.
- En ligne de commande, comparer ce que Frigate utilise avec le fichier :
curl -s http://127.0.0.1:5000/api/config | python3 -c 'import json,sys;v=json.load(sys.stdin)["cameras"]["vivotek"];print(v["zones"].keys(), v["review"]["alerts"]["required_zones"])' grep -n -A8 "zones:" /opt/frigate/config/config.yml
Configuration actuelle
- Zone
zone_active: tout le sol du jardin. - Masque d'objet « objet blanc au fond » : petite remorque blanche au pied de l'arbre, à droite (voir le journal des fausses alertes).
- Masque de mouvement « zone d'exclusion » : tout le haut de l'image.
- Les alertes exigent l'entrée dans la zone :
cameras:
vivotek:
review:
alerts:
required_zones:
- zone_active
Une personne ou une voiture détectée hors de la zone apparaît dans les détections, sans alerte ni notification.
À savoir : le masque de mouvement couvre aussi le fond du jardin. Une personne qui arrive par le fond n'est repérée qu'une fois ses jambes dans la partie non masquée. Pour la voir arriver plus tôt, réduire le masque au feuillage seulement. Un masque de mouvement ne doit pas couvrir un endroit où l'on veut détecter des objets.
Journal des fausses alertes
| Date | Ce qui s'est passé | Cause | Correction |
|---|---|---|---|
| 2026-10-09 07:57 | Alerte « Un homme se déplace et s'approche d'un arbre », alors qu'il n'y avait qu'un petit oiseau sur le chemin | L'oiseau a créé du mouvement dans l'image. Frigate a alors analysé cette partie de l'image, et le Coral a pris la petite remorque blanche au pied de l'arbre du fond pour une personne : score 0,70 (juste au seuil de 0,70), 48×91 px, immobile pendant 23 s. L'IA de hal a ensuite décrit l'image en tenant compte de l'étiquette « person » et a « vu » un homme | Masque d'objet « objet blanc au fond » (x 0,765–0,835, y 0,43–0,54) et seuil person relevé à 0,75. Captures : .notUsedNow/travail/fausse-alerte-oiseau-*.jpg. Pour éviter la suite des erreurs de ce type : ajout du vérificateur indépendant
|
À surveiller : avec un seuil de 0,75, une vraie personne lointaine ou filmée de nuit en infrarouge pourrait ne plus être retenue. Si c'est le cas, revenir à 0,7 et compter sur le masque seul.
Pour analyser une fausse alerte :
curl -s "http://127.0.0.1:5000/api/review?limit=5&severity=alert" | python3 -m json.tool | less # alertes + résumé IA curl -s "http://127.0.0.1:5000/api/events/<id>" | python3 -m json.tool # score, position (box), zones curl -s -o /opt/frigate/travail/evt.jpg "http://127.0.0.1:5000/api/events/<id>/snapshot.jpg?bbox=1"
Comparaison : modèle actuel contre YOLOv9 (2026-10-09)
Modèle testé
Frigate 0.18 accepte sur le Coral, en plus du SSD MobileNet par défaut (/edgetpu_model.tflite), les modèles YOLO (model_type: yolo-generic) quantifiés en int8 et compilés pour l'Edge TPU. Modèle déjà compilé : yolov9-s-relu6-best_320_int8_edgetpu.tflite (8,2 Mo, sha256 49a38e77…c591), avec sa liste de 17 classes COCO labels-coco17.txt (person, bicycle, car, motorcycle, airplane, bus, train, truck, boat, bird, cat, dog, horse, sheep, cow, elephant, bear), issus de https://github.com/dbro/frigate-detector-edgetpu-yolo9. Ils sont rangés dans config/model_cache/yolov9/ (soit /config/model_cache/yolov9/ dans le conteneur).
Méthode
- 942 images à la résolution de détection : les 9 événements du jour à 2 images/s (551 images) et 1 image par minute de l'enregistrement continu de la Vivotek, de 06:31 (nuit) à 14:29 (391 images). Script :
travail/yolo/extraire.sh. - Analyse par le code de détection de Frigate (
EdgeTpuDetectorConfigetLocalObjectDetector), dans l'image Frigate, sur le Coral. Chaque image est découpée en carrés de sa hauteur, ramenés à 320×320, comme des régions de mouvement. Script :travail/yolo/comparer.py. Résultats :travail/yolo/resultats.json. - Frigate a été arrêté 77 s (14:34:37 → 14:35:54) : le Coral ne peut servir qu'à un seul programme à la fois.
- Rapport visuel, avec les images côte à côte :
travail/yolo/rapport.html(scripttravail/yolo/rapport.py). Les images et le rapport sont hors de git.
Résultats
| Cas | Modèle actuel (SSD) | YOLOv9-s |
|---|---|---|
| Fausse alerte 07:57 (remorque blanche) | personne dans 8/68 images | 0/68 |
| Fausse alerte 13:53 (poubelles, Reolink) | personne dans 35/52 images (max 0,66) | 0/52 |
| Enregistrement continu, 391 images | fausse personne fixe dans 266 images (remorque : 237 ; bord gauche, poubelles et poteau : ~100, y compris la nuit) | 19 images, toutes sur la remorque et toutes < 0,7 |
| Vraie personne, 08:56 : images ≥ 0,75 | 55/96 | 61/96 (max 0,94) |
| Vraie personne, 09:11 : images ≥ 0,75 | 43/96 | 54/96 (max 0,95) |
| Personne loin (Reolink, 12:32) : images ≥ 0,7 | 18/59 | 36/59 |
| Petite VW (13:52) : images ≥ 0,7 | 28/63 | 31/63 (max 0,91) |
| Tommy (09:12) : images ≥ 0,5 | 6/96 (max 0,68) | 4/96 (max 0,59) |
| Temps par analyse (Coral USB) | 8,33 ms | 9,07 ms |
Remarque : en chiffres bruts, le SSD semblait voir des personnes dans plus d'images. L'écart venait uniquement de ses fausses personnes fixes (remorque, bord gauche). Une fois ces deux endroits écartés, YOLO voit les vraies personnes avec des scores plus élevés et ne rate aucun passage.
Conclusion : YOLOv9-s supprime presque toutes les fausses personnes, voit mieux les personnes lointaines et donne des scores plus francs, pour 0,7 ms de plus par analyse. Aucun des deux modèles ne détecte bien Tommy quand il est en partie hors de l'image.
Passage à YOLOv9 : fait le 2026-10-09 à 14:42
model: model_type: yolo-generic width: 320 height: 320 input_tensor: nhwc input_dtype: int path: /config/model_cache/yolov9/yolov9-s-relu6-best_320_int8_edgetpu.tflite labelmap_path: /config/model_cache/yolov9/labels-coco17.txt
Bloc ajouté dans config.yml le 2026-10-09 à 14:42 : Frigate a démarré avec ce modèle (« TPU found », 9,16 ms par analyse, les deux caméras à 5 i/s). Pour revenir au modèle d'origine, il suffit de supprimer ce bloc model: et de redémarrer Frigate. Après le changement, il faudra revoir les seuils (les scores YOLO sont plus élevés) et vérifier que le masque d'objet de la remorque reste utile.
Relancer la comparaison (Frigate arrêté environ 1 à 2 min) :
/opt/frigate/travail/yolo/extraire.sh docker stop frigate docker run --rm --privileged -v /dev/bus/usb:/dev/bus/usb -v /opt/frigate/travail/yolo:/work \ -v /opt/frigate/config/model_cache/yolov9:/models --entrypoint python3 ghcr.io/blakeblackshear/frigate:stable /work/comparer.py docker start frigate docker run --rm -v /opt/frigate/travail/yolo:/work --entrypoint python3 ghcr.io/blakeblackshear/frigate:stable /work/rapport.py
Vérificateur indépendant des alertes
Pourquoi
L'IA générative intégrée à Frigate ne vérifie pas les détections. La demande que Frigate envoie au modèle lui donne la liste des objets détectés comme sujets à décrire : « Treat "Objects in Scene" as the list of tracked subjects to describe ». En plus, les captures fournies portent le cadre et l'étiquette (« person: 69% »). Le modèle a donc décrit « un homme » là où il n'y avait qu'une remorque (voir le journal des fausses alertes).
Le vérificateur pose la question sans rien révéler au modèle : il utilise une capture sans annotations (snapshot-clean.webp), recadrée par ses soins autour de l'objet, et demande simplement « qu'est-ce que c'est ? ».
Fonctionnement
- Il écoute
frigate/reviewssur MQTT. Pour chaque objet d'une alerte (les détections simples ne sont pas vérifiées), il récupère la capture propre et le cadre de l'objet par l'API interne de Frigate (http://frigate:5000). - Il recadre un carré de 2,5 fois la taille de l'objet (160 px au minimum), agrandi à 448×448, et l'envoie à
qwen2.5-vl-7bsur hal. La réponse suit un format imposé :description,categorie(personne / vehicule / animal / objet / rien),confiance. Cela prend environ 2 à 7 s. - Il compare la catégorie avec l'étiquette du Coral (person → personne, car → vehicule, cat/dog → animal) :
- même catégorie → confirme ;
- autre catégorie, confiance ≥ 0,6 → faux_positif_provisoire ;
- hal injoignable, réponse illisible ou confiance faible → inconnu : rien n'est masqué.
- Sécurité contre les oublis : pendant une alerte en cours, la capture (en mémoire) et le cadre (en base) peuvent ne pas correspondre au même instant. Un faux positif trouvé pendant l'alerte est donc revérifié à la fin de l'alerte, quand les deux sont garantis cohérents. C'est seulement à ce moment-là qu'un faux_positif est retenu.
- Pour un faux positif retenu :
- la sous-étiquette « faux positif ? » est ajoutée à l'événement (visible dans Explore) ;
- l'alerte est marquée comme vue ;
- les captures sont gardées dans
verificateur/data/faux_positifs/(utiles pour Frigate+).
Sujets MQTT publiés
| Sujet | Contenu |
|---|---|
frigate_verif/available |
online / offline (conservé par le broker)
|
frigate_verif/vivotek/verdict |
Verdict pour un objet : event_id, label_coral, verdict, final, vu_par_ia, description, confiance, duree_s, erreur
|
frigate_verif/<caméra>/premier_mail |
Publié juste après le premier e-mail d'une alerte : déclenche sendingAnAlert.sh
|
frigate_verif/vivotek/alerte |
Verdict pour l'alerte : confirme (au moins un objet confirmé), en_cours (suspect, en attente de la revérification), faux_positif, inconnu
|
Notifications Home Assistant
Pour ne plus être dérangé par les fausses alertes, la notification doit se déclencher sur le verdict du vérificateur, et non sur frigate/reviews. Remplacer l'automatisation d'exemple (section « Intégration Home Assistant ») par celle-ci :
alias: Alerte vérifiée caméra Vivotek
trigger:
- platform: mqtt
topic: frigate_verif/vivotek/alerte
condition:
- condition: template
value_template: "{{ trigger.payload_json.verdict in ['confirme', 'inconnu'] }}"
action:
- service: notify.mobile_app_mon_telephone
data:
message: "Personne détectée (vérifiée) – Vivotek"
Le verdict inconnu est volontairement notifié : si hal est en panne, on préfère une fausse alerte de temps en temps à une vraie alerte manquée.
Réglages
Variables d'environnement du service verificateur dans docker-compose.yml :
| Variable | Défaut | Rôle |
|---|---|---|
LLM_URL / LLM_MODEL |
http://192.168.1.111:8090 / qwen2.5-vl-7b |
Modèle de vision utilisé |
VERIF_MIN_CONFIANCE |
0.6 | Confiance minimale pour retenir un faux positif |
VERIF_MARQUER_VUES |
1 | 0 pour ne pas marquer les fausses alertes comme vues |
Utilisation
Voir le wiki d'utilisation (Frigate_utilisation.wiki), section « Suivre le vérificateur ».
Envoi d'e-mails : réglages
Ce que contiennent les e-mails : wiki d'utilisation, « E-mails d'alerte ».
Serveur d'envoi : mail.apsi.net, port 587 (STARTTLS), compte pchevalier@apsi.net (identification testée le 2026-10-09). Les identifiants sont dans /opt/frigate/.env (hors git) :
SMTP_HOST=mail.apsi.net SMTP_PORT=587 # 465 = SSL direct SMTP_USER=pchevalier@apsi.net SMTP_PASSWORD=... MAIL_FROM=pchevalier@apsi.net MAIL_TO=pchevalier@apsi.net # plusieurs adresses séparées par des virgules
Réglages facultatifs (dans .env ou dans la section environment du service) :
MAIL_VIDEO_MAX_MO(37) : taille maximale de la vidéo jointe.mail.apsi.netaccepte au plus 50 Mio par e-mail (vérifié par la commande SMTPEHLO, valeurSIZE 52428800). Comme l'encodage base64 grossit les pièces jointes de 37 %, une vidéo de plus de ~37 Mo serait refusée par le serveur. Au-delà de cette taille, la vidéo est convertie en 720p H.264 à 12 i/s (ffmpeg dans le conteneur, en priorité basse, 2 cœurs, ~70 s pour 1 min de 4K), et l'e-mail renvoie vers Frigate pour la pleine qualité. Si la conversion échoue, seul le lien est donné ;MAIL_IGNORER_CONNUS(1) : mettre 0 pour recevoir aussi un e-mail quand la personne est reconnue ;MAIL_NOMS_SANS_MAIL(vide) : liste des personnes reconnues qui ne déclenchent pas d'e-mail, séparées par des virgules (par exemplePatrick,Marie José). Si la liste est vide, aucune personne reconnue ne déclenche d'e-mail ;FRIGATE_URL_PUBLIQUE: adresse utilisée pour les liens.
Attention : .env est aussi lu par Frigate. Après l'avoir modifié, docker compose up -d recrée aussi Frigate. Pour ne relancer que le vérificateur :
docker compose up -d --no-deps --force-recreate verificateur
Test réalisé le 2026-10-09 : l'alerte réelle de 08:56 a été rejouée, et l'e-mail a été envoyé avec les photos et la vidéo (5,7 Mo). Si l'e-mail n'arrive pas : docker compose logs verificateur | grep -i e-mail.
Incident du 2026-10-09 à 15:07 (arrivée de la VW, Marie-José au volant, descendue dans le garage) : aucun e-mail. Le vérificateur avait jugé l'alerte fausse. Pendant l'alerte, l'image et le cadre de la voiture en mouvement étaient décalés (« deux poubelles vertes »). À la revérification, l'IA a vu « un être humain à l'intérieur d'une voiture » et a choisi la catégorie unique « personne », d'où le refus pour un objet « car ». Corrections : l'IA renvoie désormais toutes les catégories présentes (categories_presentes), et l'objet est confirmé si la sienne en fait partie ; en cas de doute pendant l'alerte, un second essai 3 s plus tard a lieu. L'alerte a été rétablie (sous-étiquette effacée, marquée non vue) puis rejouée : « confirmé » (personne + véhicule), e-mails envoyés à 15:12:53 et 15:13:32.
Incident du 2026-10-09 à 13:51 (personne puis voiture sur la Reolink) : le second e-mail était arrivé sans pièce jointe (vidéo 4K H.265 de 49 Mo, refusée au-delà de 15 Mo, et pas de photo de la voiture), et la messagerie avait groupé les deux e-mails en une seule conversation. Corrigé (limite de 37 Mo, conversion en 720p, photos des nouveaux objets). L'alerte rejouée à 14:15 a donné un premier e-mail avec 2 photos, puis un second avec la photo de la voiture et la vidéo 720p (4,5 Mo).
Script lancé à chaque alerte
Voir le wiki d'utilisation (Frigate_utilisation.wiki), section « Script lancé à chaque alerte : sendingAnAlert.sh ».
Tests effectués le 2026-10-09
| Cas | Réponse du modèle | Verdict |
|---|---|---|
| Capture avec cadre et étiquette « person: 69% » (ce que Frigate fournit) | « Un être humain est partiellement visible dans un cadre bleu » | personne : trompé par l'étiquette |
| Même capture, propre, recadrée | « Un objet rectangulaire avec des motifs de grille » | objet (0,8) |
| Alerte de 07:57 rejouée de bout en bout (MQTT) | « Un objet inanimé, probablement une remorque, est attaché à un arbre » | faux_positif_provisoire → faux_positif à la fin ; sous-étiquette posée, alerte marquée vue |
| Vraie alerte de 08:56 (une personne dans l'allée, score Coral 0,84) | « Un homme debout dans un jardin » (0,95) | confirme |
À surveiller : les scènes de nuit en infrarouge n'ont pas encore été testées. Si une vraie personne est classée en faux positif, mettre VERIF_MARQUER_VUES=0 et relever VERIF_MIN_CONFIANCE, puis analyser le cas dans verifications.jsonl.
Reconnaissance, personnes et animaux connus
Voir le wiki d'utilisation (Frigate_utilisation.wiki), section « Reconnaissance des visages », « Personnes et animaux connus », « Tommy (le chien) » et « Logiciel d'éducation (eduquer.sh) ».
Lecture des plaques
Activée le 2026-10-09 (lpr, modèle small, sur le processeur : détecteur de plaque YOLOv9 et lecture PaddleOCR, téléchargés automatiquement). Les plaques connues deviennent la sous-étiquette de l'objet « car » :
lpr:
enabled: true
model_size: small
min_plate_length: 7
known_plates:
VW: # « petite VW » jusqu'au 2026-10-12
- GL-117-AW
- GL117AW
RAV4 Toyota: # ajoutée le 2026-10-12, avant le premier passage
- HF-515-AL
- HF515AL
La plaque de la petite VW est lisible sur l'image de détection de la Reolink (voiture de 321×330 px, sur 896×512) lors du passage de 13:52.
Arrivée de 15:07 : plaque non lue. La voiture était de trois quarts, et la plaque, en biais, faisait ~36×20 px (~720 px²) sur l'image de détection. Or Frigate ignore les plaques de moins de min_area (1 000 px² par défaut). De plus, il cesse de chercher la plaque d'une voiture immobile depuis quelques secondes (la voiture attendait l'ouverture du garage). Réglages ajoutés pour la Reolink :
cameras:
garage:
lpr:
min_area: 400
enhancement: 3 # amélioration d'image des petites plaques (0 à 10)
À vérifier aux prochaines arrivées. Une plaque très en biais reste difficile à lire.
Intégration Home Assistant
Aucun Home Assistant n'a été trouvé sur le réseau 192.168.1.x au moment de l'installation. Le broker est prêt à le recevoir.
Étape 1 : intégration MQTT
Dans Home Assistant : Paramètres → Appareils et services → Ajouter une intégration → MQTT.
| Champ | Valeur |
|---|---|
| Broker | 192.168.1.247
|
| Port | 1883
|
| Utilisateur | frigate, ou un compte dédié (voir ci-dessous)
|
| Mot de passe | indiqué dans /opt/frigate/.env (FRIGATE_MQTT_PASSWORD)
|
Il est conseillé de créer un compte dédié à Home Assistant :
cd /opt/frigate docker exec -it mosquitto mosquitto_passwd /mosquitto/config/passwd homeassistant docker compose restart mosquitto
Changer un mot de passe MQTT
/opt/frigate/changer-mdp-mqtt.sh # compte frigate : broker + .env + identifiants.txt + reconnexion de Frigate /opt/frigate/changer-mdp-mqtt.sh homeassistant # autre compte (crée le compte s'il n'existe pas)
Il faut ensuite reporter le nouveau mot de passe dans Home Assistant (Appareils et services → MQTT → Reconfigurer). Si l'on modifie .env à la main, il faut recréer le conteneur avec docker compose up -d --force-recreate frigate : un simple restart ne relit pas .env.
Étape 2 : intégration Frigate
- Installer HACS dans Home Assistant (voir https://hacs.xyz).
- Dans HACS, chercher et installer Frigate (
blakeblackshear/frigate-hass-integration), puis redémarrer Home Assistant. - Ajouter une intégration → Frigate, avec l'URL :
http://192.168.1.247:5000.
Home Assistant crée alors automatiquement :
- une entité caméra
camera.vivotek; - des capteurs de présence (
binary_sensor.vivotek_person_occupancy…) ; - des compteurs d'objets ;
- des interrupteurs (détection, enregistrement, captures…) ;
- des capteurs de zone, par exemple
binary_sensor.zone_active_person_occupancy(une personne est dans la zone active).
Sujets MQTT utiles
| Sujet | Contenu |
|---|---|
frigate/available |
online / offline
|
frigate/events |
Événements de détection, au format JSON (début, mise à jour, fin) |
frigate/reviews |
Alertes et détections à revoir |
frigate/vivotek/person |
Nombre de personnes visibles |
frigate/vivotek/motion |
ON / OFF
|
frigate/vivotek/person/snapshot |
Dernière capture JPEG d'une personne |
frigate/vivotek/detect/set |
Commande : ON / OFF pour activer ou couper la détection
|
frigate/vivotek/recordings/set |
Commande : ON / OFF pour activer ou couper l'enregistrement
|
Exemple d'automatisation (notification)
Remplacé par l'automatisation basée sur le vérificateur (section « Vérificateur indépendant des alertes »). La version ci-dessous notifie aussi les fausses alertes.
alias: Personne détectée devant la caméra Vivotek
trigger:
- platform: mqtt
topic: frigate/reviews
condition:
- condition: template
value_template: >
{{ trigger.payload_json.type == 'new' and
trigger.payload_json.after.severity == 'alert' and
'person' in trigger.payload_json.after.data.objects }}
action:
- service: notify.mobile_app_mon_telephone
data:
message: "Personne détectée (Vivotek)"
Bluetooth et météo (2026-10-13)
- Bluetooth : le paquet
bluez(servicebluetooth) n'était pas installé sur 5050, d'où des centaines d'erreurshabluetooth … Failed to force stop scanner. Installé et activé le 2026-10-13 ; l'adaptateurhci0est utilisé par HA via/run/dbus. - Météo : en plus de Met.no (
weather.forecast_maison), l'intégration Météo-France a été ajoutée pour Baugé-en-Anjou (47.54278, -0.10389) :weather.meteo_france_forecast_for_city_bauge_en_anjou_bauge, pluie dans l'heure, risque de pluie, UV, vigilance du 49. - Tableau de bord Maison, section « Aujourd'hui » : sous la carte quotidienne, carte heure par heure Météo-France et tuiles pluie / vigilance / UV.
- La carte météo de HA n'a pas de détail par jour : un clic ouvre toujours la même fenêtre (onglets Quotidien / Horaire), quel que soit le jour cliqué.
- Sauvegardes avant modification :
/opt/homeassistant/.notUsedNow/core.config_entries.bak-20261013-060523etlovelace.dashboard_maison.bak-20261013-060523.
Ajouts du 2026-10-13 : énergie, serveurs, Frigate
- Énergie : le tableau de bord Énergie de HA était déjà configuré (réseau EDF + panneaux, capteurs SQL pcNrgy5). Corrigé : les requêtes du jour (
config/packages/energie.yaml) bornent la production à 0 (l'onduleur mesure −2 W la nuit, ce qui rendait le total négatif). - Prévision solaire : intégration Forecast.Solar, valeurs estimées : 9 000 Wc (pic mesuré 8,15 kW le 2026-08-22), plein sud (180°), inclinaison 30°. À corriger dans Paramètres → Appareils et services → Forecast.Solar si besoin. Reliée au tableau de bord Énergie ; tuiles en haut de la vue « Énergie » (aujourd'hui, reste du jour, demain).
- Surveillance des serveurs : vue « Serveurs » du tableau de bord Maison.
- 5050 : intégration System Monitor (CPU, température, mémoire, disque, charge).
- srv18 et hal :
/opt/homeassistant/surveiller-serveurs.sh(cron/etc/cron.d/surveiller-serveurs, toutes les 2 min) relève CPU, charge, mémoire, disque /, température, durée de fonctionnement par SSH et écritconfig/serveurs/<serveur>.json, lu parconfig/packages/serveurs.yaml. Relevé de plus de 10 min = hors ligne. - Alertes (
automations.yaml) : serveur hors ligne 10 min, température > 85 °C ou disque > 90 % pendant 10 min → notification dans HA (en attendant SMS / mail).
- Frigate : intégration officielle v5.15.6 copiée dans
config/custom_components/frigate(pas de HACS), reliée àhttp://127.0.0.1:5000. Intégration MQTT ajoutée le 2026-10-13 (broker 127.0.0.1:1883, comptehomeassistant, mot de passe choisi par l'utilisateur, dansidentifiants.txt) : 104 entités Frigate dans HA. - Voiture ou personne la nuit (
config/packages/frigate.yaml) : nouvel objetcarouperson(pas les chiens ni les chats) surfrigate/eventset soleil couché → Floods-Parc allumé 2 min (relancé à chaque nouvelle voiture ; pas éteint s'il était déjà allumé à la main). Testé le 2026-10-13 à 07:05 (fausse détection publiée sur MQTT) : allumé puis éteint 2 min après. - Secours si Frigate ne reconnaît pas la voiture (même fichier, automatisation
mouvement_nuit_sans_objet) : la voiture rentrée le 2026-10-13 à 06:44 n'a pas été reconnue : ses phares ont fait basculer la Reolink de l'infrarouge à la couleur.- Détecteur de phares :
/opt/frigate/detecteur-phares.py(servicedetecteur-phares.service, journaljournalctl -u detecteur-phares). Toutes les 2 s, mesure la saturation de/api/garage/latest.jpg: 0,0 en infrarouge, 6 à 14 éclairé par des phares. Publiefrigate_secours/garage/couleurON/OFF (conservé) →binary_sensor.garage_image_en_couleurdans HA. Floods-Parc n'éclaire pas assez la caméra pour la faire basculer (vérifié à 07:15 et 07:32). - Passage en couleur, soleil à plus de 6° sous l'horizon (à l'aube la caméra bascule d'elle-même : 08:01:47 le 2026-10-13, soleil à −3,1°) → Floods-Parc 2 min ; si Frigate ne suit aucun objet 5 s plus tard, événement manuel
mouvement(POST /api/events/garage/mouvement/create) : enregistrement de 2 min gardé 30 jours, alerte dans Frigate, mail avec film du vérificateur. - Le simple mouvement n'est plus utilisé : la pluie l'a déclenché (faux mail Maison des Tracteurs le 2026-10-13 à 07:51).
- Garde-fous : rien dans les 90 s qui suivent un changement de Floods-Parc ; au plus un événement manuel (donc un mail) toutes les 2 min. Les lampes et les détections normales ne sont jamais limitées.
- Détecteur de phares :
- Sauvegardes avant modification :
/opt/homeassistant/.notUsedNow/*.bak-20261013-*.
IA générative sur hal
Principe
Le Coral reste chargé de la détection : il repère les personnes, voitures et animaux. Pour chaque objet suivi et chaque alerte, Frigate envoie ensuite des images à un modèle qui lit les images (un modèle de vision), hébergé sur hal. Ce modèle renvoie une description en langage naturel.
Cela permet :
- de lire une description de chaque objet, dans Explore ;
- de faire une recherche en langage naturel (recherche sémantique, avec le modèle Jina, qui tourne sur le processeur de la machine Frigate) : « personne avec un sac », « voiture blanche »… ;
- d'obtenir un résumé de chaque alerte, avec une estimation de son niveau de menace (en français) ;
- d'utiliser le chat de Frigate, assuré par gpt-oss-120b.
Le modèle du Coral n'est pas réentraîné par cette IA. Pour l'améliorer, voir les réglages de filtres et de masques, ou Frigate+.
Côté hal (192.168.1.111)
| Élément | Valeur |
|---|---|
| Matériel | iGPU AMD gfx1151 (Strix Halo), 96 Go de mémoire réservée au GPU, Vulkan/RADV |
| Service | llama-server.service, en mode routeur, port 8090
|
| Modèle de vision | qwen2.5-vl-7b : /data/ai/models/gguf/qwen2.5-vl-7b/ (Q4_K_M + mmproj f16, contexte 16k, environ 7 Go)
|
| Déclaration | section [qwen2.5-vl-7b] de /data/ai/models.ini
|
| Modèles chargés simultanément | 2 (--models-max 2 dans /etc/systemd/system/llama-server.service.d/override.conf, auparavant 1)
|
| Sauvegardes | models.ini.bak-* et override.conf.bak-*
|
Mémoire GPU mesurée avec gpt-oss-120b et qwen2.5-vl-7b chargés, plus les services sur les ports 8012 et 8091 : environ 80 Go sur 96.
⚠ Attention : le routeur décharge le modèle utilisé le moins récemment. Si l'on passe à qwen3-coder-next (62 Go, contexte de 262 000 tokens) juste après une requête de Frigate, c'est qwen2.5-vl-7b qui est déchargé. Le routeur essaie alors de garder gpt-oss-120b et qwen3-coder-next en même temps, ce qui dépasse les 96 Go. Avant d'utiliser qwen3-coder-next, il faut donc décharger gpt-oss-120b (ou revenir provisoirement à --models-max 1).
Commandes sur hal :
/data/ai/switch-llm.sh status # modèles chargés / déchargés journalctl -u llama-server -f # journaux cat /sys/class/drm/card0/device/mem_info_vram_used # mémoire GPU utilisée (octets)
Côté Frigate
Extrait de config.yml :
genai:
hal_vision:
provider: llamacpp
base_url: http://192.168.1.111:8090
model: qwen2.5-vl-7b
roles: [descriptions]
hal_chat:
provider: llamacpp
base_url: http://192.168.1.111:8090
model: gpt-oss-120b
roles: [chat]
semantic_search:
enabled: true
model_size: small
cameras:
vivotek:
objects:
genai:
enabled: true
objects: [person, car, cat, dog]
review:
genai:
enabled: true
alerts: true
detections: false
preferred_language: French
Au démarrage, Frigate vérifie le modèle et l'indique dans ses journaux :
docker logs frigate 2>&1 | grep llama_cpp # llama.cpp model 'qwen2.5-vl-7b' initialized — context: 16384, vision: True ...
Chaque description prend environ 6 secondes. Si hal est éteint, Frigate continue de détecter et d'enregistrer normalement ; seules les descriptions manquent.
Surveillance automatique
Depuis le 2026-10-12, le script /opt/frigate/verifier-dockers.sh vérifie toutes les 5 minutes les conteneurs de Frigate (frigate, mosquitto, verificateur) et de Home Assistant (homeassistant, dans /opt/homeassistant). Il corrige ce qu'il peut et envoie un mail à MAIL_TO (au 2026-10-12 : pchevalier@apsi.net, la même boîte que les alertes Frigate), en passant par le serveur SMTP de /opt/frigate/.env (les mêmes réglages que les alertes Frigate). Chaque mail indique le nom du serveur, l'emplacement et le nom du script.
| Élément | Emplacement |
|---|---|
| Script | /opt/frigate/verifier-dockers.sh
|
| Tâche cron | /etc/cron.d/verifier-dockers (*/5 * * * *, avec flock pour ne jamais lancer deux vérifications à la fois)
|
| Journal | /opt/frigate/verifier-dockers.log (une ligne par passage ; rotation mensuelle par /etc/logrotate.d/verifier-dockers)
|
| État | /opt/frigate/travail/verifier-dockers.etat (problème en cours, corrections récentes, compteurs de redémarrage)
|
Ce qui est vérifié, et la correction appliquée
| Vérification | Correction automatique |
|---|---|
| conteneur absent, arrêté ou en cours de redémarrage | docker compose up -d <service>
|
| mosquitto relancé | redémarrage de frigate aussi : Frigate ne retente pas la connexion MQTT (voir « Mosquitto arrêté après un redémarrage du serveur »)
|
conteneur qui redémarre en boucle (RestartCount qui augmente) |
verificateur : docker restart (si mosquitto tourne)
|
| Frigate « unhealthy », API (port 5000) muette, caméra sous 1 image/s, détecteur Coral absent ou lent (plus de 100 ms) | docker restart frigate
|
Frigate n'a publié aucun message MQTT (frigate/stats) depuis 75 s |
docker restart frigate
|
Home Assistant ne répond pas 200 sur https://127.0.0.1:8123/manifest.json |
docker restart homeassistant
|
stockage NFS (srv18:/data/frigate) inaccessible ou moins de 50 Go libres ; disque local à moins de 10 % libres |
aucune : mail seulement |
Garde-fous
- Rien n'est fait dans les 5 minutes qui suivent le démarrage du serveur.
- Un conteneur démarré depuis moins de 4 minutes n'est pas jugé sur sa santé (seulement sur le fait qu'il tourne).
- Au plus 3 corrections par conteneur et par heure. Au-delà, le mail a pour sujet « INTERVENTION MANUELLE NÉCESSAIRE ».
- Un problème non résolu n'est rappelé par mail que toutes les 6 heures. Un mail « retour à la normale » est envoyé quand tout est rentré dans l'ordre.
Mails envoyés
- « problème détecté et corrigé » : constats, commandes lancées, état des conteneurs 2 minutes après ;
- « problème détecté (pas de correction automatique) », par exemple pour le stockage ;
- « INTERVENTION MANUELLE NÉCESSAIRE » ;
- « retour à la normale ».
Commandes utiles
/opt/frigate/verifier-dockers.sh --verbeux # vérification à la main, avec le détail à l'écran /opt/frigate/verifier-dockers.sh --test-mail # envoie un mail de test tail -f /opt/frigate/verifier-dockers.log
Pour suspendre la surveillance, par exemple pendant une maintenance où l'on arrête des conteneurs exprès : mettre la ligne de /etc/cron.d/verifier-dockers en commentaire.
Essai du 2026-10-12
docker stop mosquitto à 17:41:25, puis lancement du script : il a relancé mosquitto, redémarré Frigate et envoyé le mail « problème détecté et corrigé » à 17:43:44. Au passage suivant, Frigate, verificateur et frigate-declencheur étaient reconnectés au broker, et le mail « retour à la normale » est parti.
Dépannage
« No EdgeTPU was detected »
Cette erreur apparaît surtout au premier démarrage après un branchement du Coral ou un redémarrage du serveur. Le Coral change alors d'identifiant USB (de 1a6e:089a à 18d1:9302), et la première tentative échoue. Solution :
docker restart frigate docker logs frigate 2>&1 | grep TPU # doit afficher « TPU found »
Si l'erreur continue :
- vérifier
lsusb | grep -E "1a6e|18d1"; - préférer un port USB 3 ;
- éviter les hubs USB non alimentés.
La caméra ne s'affiche pas
ping 192.168.1.199 ffprobe -rtsp_transport tcp rtsp://192.168.1.199:554/live2.sdp
Si un mot de passe est un jour activé sur la caméra, modifiez les URL dans config.yml (section go2rtc), sous la forme rtsp://utilisateur:motdepasse@192.168.1.199:554/live.sdp.
Mosquitto arrêté après un redémarrage du serveur
Le 2026-10-12, après le redémarrage de 15:19, mosquitto est resté arrêté (sorti proprement à l'arrêt du serveur, code 0, non relancé malgré restart: unless-stopped). Conséquences : verificateur redémarrait en boucle (Name or service not known sur mosquitto) et Frigate n'était pas connecté au broker. Frigate ne retente pas la connexion MQTT s'il a démarré sans broker : il faut le redémarrer après le broker.
cd /opt/frigate && docker compose up -d mosquitto docker restart frigate docker logs --since 2m mosquitto | grep "New client" # doit montrer frigate, frigate-verificateur, frigate-declencheur
Depuis, le script /opt/frigate/verifier-dockers.sh (voir « Surveillance automatique ») le détecte et le corrige tout seul.
Home Assistant ne reçoit rien
- Au 2026-10-12, Home Assistant (conteneur
homeassistant) n'a encore aucune intégration MQTT ni Frigate : voir « Intégration Home Assistant ». - Vérifier que le broker tourne :
docker compose ps mosquitto. - Vérifier les identifiants :
docker compose logs mosquittoaffiche not authorised en cas d'erreur. - Vérifier que le port 1883 est accessible depuis Home Assistant (pare-feu).
La caméra saccade / « Ffmpeg process crashed »
Avec le décodage automatique (VAAPI), ffmpeg plantait toutes les 30 à 60 secondes sur l'Intel HD 630 (Failed to sync surface). Le passage à hwaccel_args: preset-intel-qsv-h264 a corrigé le problème. Si cela revient, on peut aussi décoder sur le processeur en supprimant la ligne hwaccel_args et en mettant hwaccel_args: "".
Heure de la caméra
Caméra : Vivotek IB8369A, firmware IB8369A-VVTK-0200e.
Le 2026-10-09, l'horodatage incrusté avait 58 minutes de retard pour deux raisons : le fuseau était GMT+1 sans heure d'été, et la synchronisation NTP ne fonctionnait pas (l'horloge avançait d'environ 2 minutes). Réglages appliqués :
| Paramètre | Avant | Après |
|---|---|---|
system_timezoneindex |
40 (GMT+1, Paris) | 40 (inchangé) |
system_daylight_enable (heure d'été) |
0 | 1 |
system_ntp |
145.238.203.10 | fr.pool.ntp.org |
system_updateinterval |
3600 s | 3600 s (inchangé) |
L'heure a aussi été remise à l'heure du serveur Frigate.
Lecture et modification des réglages (tant que la caméra n'a pas de mot de passe) :
curl "http://192.168.1.199/cgi-bin/admin/getparam.cgi?system_date&system_time&system_ntp&system_daylight_enable" curl -G "http://192.168.1.199/cgi-bin/admin/setparam.cgi" --data-urlencode "system_date=$(date +%Y/%m/%d)" --data-urlencode "system_time=$(date +%H:%M:%S)"
Si l'heure dérive de nouveau, c'est que la caméra n'arrive pas à joindre le serveur NTP. On peut alors installer un serveur de temps (chrony) sur la machine Frigate, puis faire pointer system_ntp vers 192.168.1.247.
Nom de la caméra Vivotek
Depuis le 2026-10-09 :
- texte incrusté « Maison des Tracteurs » (
videoin_c0_text), à côté de l'heure. La Vivotek ne place ce texte qu'en haut ou en bas (videoin_c0_textonvideo_position), sur la même ligne que l'heure. On le garde en haut : en bas, les chiffres de l'heure tomberaient danszone_activeet créeraient du mouvement en permanence ; - nom affiché dans Frigate :
friendly_name: Maison des Tracteurs. Le nom techniquevivotek(API, MQTT, enregistrements) ne change pas. Le vérificateur utilise ce nom dans les e-mails.
curl -G "http://192.168.1.199/cgi-bin/admin/setparam.cgi" --data-urlencode "videoin_c0_text=Maison des Tracteurs"
Pas de description IA
- Vérifier que hal répond :
curl http://192.168.1.111:8090/v1/models. - Vérifier les journaux :
docker logs frigate 2>&1 | grep -i -E "genai|llama". - Le premier appel peut prendre 10 à 60 secondes si le modèle doit être rechargé sur hal.
Ne garder que l'intéressant (2026-10-10)
Constat de Patrick : d'une vidéo à l'autre, il ne change presque rien, à part le temps et la lumière. Mesures sur l'heure précédant le changement : Vivotek ~14 Go/jour, Reolink ~64 Go/jour, alors qu'elle n'était censée garder que le mouvement. Elle avait conservé les 360 segments de l'heure : sans masque, le saule et le bruit nocturne étaient du « mouvement » permanent.
| Levier | Avant | Après | Gain mesuré |
|---|---|---|---|
Encodage Vivotek (videoin_c0_s0_h264_*) |
débit constant (CBR) 2 Mbit/s, image complète toutes les 1 s (intraperiod=1000) |
débit variable (ratecontrolmode=vbr, qualité 29, plafond maxvbrbitrate=2000000), image complète toutes les 4 s (intraperiod=4000) |
0,41 Mbit/s, ~4,4 Go/jour (mesure de jour), au lieu de 14,1 : ÷ 3 |
Encodage Reolink (SetEnc) |
4K H.265 6 Mbit/s, 25 i/s | 4K H.265 4 Mbit/s (le minimum proposé), 15 i/s. Pas de débit variable dans son API | 4,4 Mbit/s, ~48 Go/jour en continu, au lieu de 64 : –25 % |
| Masque Reolink | aucun | « haut des arbres » : les 45 % du haut de l'image (ciel, saule, heure incrustée), à ajuster dans l'interface | moins de faux mouvement |
| Conservation (les deux caméras) | Vivotek : tout 7 j, mouvement 15 j ; Reolink : mouvement 7 j ; alertes et détections 30 j mode: all |
08:14 : tout 2 j, mouvement 3 j. 08:50 (demande de Patrick : « quel intérêt de garder des vidéos où rien n'a été détecté ? ») : pas de continu, mouvement 1 j, alertes et détections 30 j mode: active_objects (seulement les segments où un objet suivi est présent) |
à mesurer |
| Time-lapse | – | 1 image/min de la veille → vidéo 24 i/s (~1 min), 960 px | ~4 Mo/jour (Vivotek), ~2 Mo/jour (Reolink) |
Sauvegardes des réglages d'origine : .notUsedNow/travail/vivotek-videoin_c0_s0-avant.txt, .notUsedNow/travail/reolink-GetEnc-avant.json, .notUsedNow/config/config.yml.bak-*. Au changement d'encodage de la Reolink, Frigate a perdu le flux quelques secondes (« unusable »), puis s'est reconnecté tout seul.
Revenir en arrière (Vivotek) :
curl -G "http://192.168.1.199/cgi-bin/admin/setparam.cgi" --data-urlencode "videoin_c0_s0_h264_ratecontrolmode=cbr" --data-urlencode "videoin_c0_s0_h264_intraperiod=1000"
Pourquoi garder quand même 1 jour de mouvement : c'est le seul moyen de rattraper ce que Frigate n'a pas détecté. Le 2026-10-09, Tommy a traversé l'image sans être détecté, et une personne mal éclairée la nuit pourrait aussi passer inaperçue. Pour tout supprimer en dehors des détections : motion: days: 0.
Time-lapse quotidien
Voir le wiki d'utilisation (Frigate_utilisation.wiki), section « Time-lapse quotidien » et « E-mail quotidien des time-lapses ».
Stockage sur srv18 (NFS)
Depuis le 2026-10-09 à 17:44, /opt/frigate/storage est un montage NFS de srv18:/data/frigate (disque /data de srv18 : 1,8 To, ~455 Go libres). Les enregistrements, captures, miniatures et visages appris sont donc sur srv18. La base de Frigate (config/frigate.db) reste sur le disque local : c'est indispensable, SQLite ne doit pas être sur NFS.
- srv18 : export dans
/etc/exports:/data/frigate 192.168.1.243(rw,sync,no_subtree_check,no_root_squash) 192.168.1.247(rw,sync,…). Servicenfs-server. - 5050 : ligne
/etc/fstab(sauvegarde de la version précédente dans.notUsedNow/travail/fstab.avant-*) :
srv18:/data/frigate /opt/frigate/storage nfs rw,noatime,nolock,bg,nfsvers=4,intr,tcp,nofail,x-systemd.automount 0 0
- grâce à
x-systemd.automount, le partage est monté au premier accès, par exemple au démarrage du conteneur Frigate.
- Historique : le transfert a été fait le 2026-10-09 par une autre session. Il a copié
storagevers srv18, l'a monté sur/data/frigateet renommé le dossier local enstorage.old, puis arrêté Frigate (17:28). La copie desclipsétait incomplète (392 fichiers sur 1 737, visages compris). Elle a été terminée parrsync, puis vérifiée (recordings 4 945 = 4 945, clips 1 737 = 1 737, visages identiques). Le montage a été déplacé sur/opt/frigate/storageet Frigate relancé à 17:44, soit 16 min sans enregistrement. storage.old(20 Go, sur le disque local) : ancienne copie, conservée par précaution, à supprimer après quelques jours sans problème (rm -rf /opt/frigate/storage.old).
Points d'attention :
- si srv18 est éteint ou injoignable, Frigate ne peut plus enregistrer, et le montage
hardpeut bloquer les accès jusqu'au retour de srv18. Les détections et e-mails dépendent aussi de l'accès aux captures ; - Frigate voit l'espace libre de tout le disque
/datade srv18, qu'il partage avec d'autres données. Il ne supprime les anciennes vidéos qu'en dessous d'environ 1 h d'enregistrement libre. Les durées de conservation doivent donc rester raisonnables pour ne pas remplir/data; - vérifier :
findmnt /opt/frigate/storage(doit affichersrv18:/data/frigate nfs4) etcurl -s http://127.0.0.1:5000/api/stats | python3 -m json.tool | grep -A4 media.
Espace disque
Dimensionnement (mesuré le 2026-10-09) : le flux 1080p fait environ 0,8 Mbit/s de jour, soit ~9 Go par jour d'enregistrement continu. Cette valeur a été confirmée sur une heure d'enregistrement réel. Il faut s'attendre à plus la nuit, en infrarouge (image plus « bruitée »). Les vidéos sont sur le disque système. Il faut y garder environ 30 Go de marge pour le système.
Historique des réglages :
- 30 jours de continu (réglé depuis l'interface) ≈ 260 Go : ne tient pas. Frigate supprimerait les vidéos les plus anciennes et le disque système resterait plein en permanence. Ramené à 7 jours le 2026-10-09 (97 Go libres alors).
- Après un ménage sur le disque (162 Go libres), passage à 10 jours le même jour : ≈ 90 Go de continu, plus les passages avec mouvement (15 jours) et les alertes (30 jours), soit ~105 Go estimés.
- À l'ajout de la Reolink (4K, ~67 Go par jour), retour à 7 jours pour la Vivotek ; la Reolink n'enregistre que les passages avec mouvement (7 jours).
| Continu | Place estimée (avec mouvement 15 j et alertes 30 j) | Avec 162 Go libres |
|---|---|---|
| 7 jours (actuel) | ~75 Go | large marge, laissée pour les passages en 4K de la Reolink |
| 10 jours | ~105 Go | conseillé (sans la Reolink) |
| 14 jours | ~140 Go | trop juste si les nuits consomment plus |
| 30 jours | ~280 Go | impossible sans disque dédié |
Suivi : df -h / et du -sh /opt/frigate/storage/recordings. Après une semaine, mesurer le débit réel avec les nuits :
find /opt/frigate/storage/recordings -name '*.mp4' -mmin -1440 -printf '%s\n' | awk '{s+=$1} END{printf "%.1f Go sur 24 h\n", s/1e9}'
Si le débit reste proche de 9 Go par jour, on peut monter à 12, voire 14 jours.
Pour garder plus longtemps : ajouter un disque dédié monté sur /opt/frigate/storage.
Les enregistrements sont stockés dans /opt/frigate/storage, sur la partition racine (environ 105 Go libres à l'installation). Frigate supprime automatiquement les fichiers les plus anciens selon les durées de conservation, et en urgence si le disque est presque plein. Pour suivre l'occupation :
du -sh /opt/frigate/storage
HTTPS
Certificat Let's Encrypt (depuis le 2026-10-13)
Le certificat de l'autorité locale (ci-dessous) n'était pas accepté par les navigateurs qui n'avaient pas importé ca.crt. Depuis le 2026-10-13, Frigate, Home Assistant et les redirections Apache utilisent un vrai certificat Let's Encrypt :
- demandé et renouvelé par ovh1 (certbot,
/etc/letsencrypt/live/fr.headscale.pcstreet.org/, clé ECDSA) ; srv18 en a une copie, mais la source est ovh1 ; - noms couverts :
fr.headscale.pcstreet.org,frigate.headscale.pcstreet.org,ha.headscale.pcstreet.org,homeassistant.headscale.pcstreet.org. Les 4 noms pointent dans le DNS vers100.64.254.9(adresse Tailscale de 5050) ; - les adresses IP (192.168.1.247…) et les anciens noms ne sont plus couverts : y accéder affiche un avertissement. Adresses à utiliser :
https://frigate.headscale.pcstreet.org:8971(oufr.) ethttps://ha.headscale.pcstreet.org:8123(ouhomeassistant.). Sans le port, Apache redirige (ports 80 et 443) ; - récupération automatique :
https/recuperer-certificat.sh, lancé chaque nuit à 4h17 par/etc/cron.d/recuperer-certificat. Il copiefullchain.pemetprivkey.pemde ovh1 (scp, clé SSH de root), vérifie qu'ils sont valides et assortis, et seulement s'ils ont changé les installe danshttps/frigate/et/opt/homeassistant/ssl/, redémarre Frigate et Home Assistant et recharge Apache. Journal :https/recuperer-certificat.log; - anciens certificats de l'autorité locale :
.notUsedNow/https-frigate.bak-20261013et/opt/homeassistant/.notUsedNow/ssl.bak-20261013. La suite de cette section décrit l'ancienne organisation, gardée pour l'historique.
Principe
Mis en place le 2026-10-09 pour supprimer l'avertissement de sécurité et le piège du http://.
- Une autorité de certification locale, « Autorité Frigate Maison » (
https/ca.crt, valable 10 ans, clé RSA 4096), signe le certificat de Frigate. - Certificat de Frigate (
https/frigate/, RSA 2048, valable 825 jours) pour les noms et adresses :192.168.1.247,192.168.1.243,frigate,frigate.lan,5050,frigate.pcstreet.org,5050.pcstreet.org. Les deux noms pcstreet ont été ajoutés le 2026-10-09 à 17:58 : Patrick accède parhttps://frigate.pcstreet.org:8971, déclaré dans/etc/hostsde srv18 (192.168.1.247 frigate.pcstreet.org 5050 5050.pcstreet.org). Sans ces noms dans le certificat, Firefox affichait « risque probable de sécurité » malgré l'autorité installée (nom non couvert par le certificat). Version précédente :.notUsedNow/https/ancien-*. Le dossier est monté en lecture seule dans le conteneur, à l'emplacement où Frigate cherche son certificat (/etc/letsencrypt/live/frigate/fullchain.pemetprivkey.pem). Frigate ne génère plus de certificat auto-signé. - Redirection : site Apache
/etc/apache2/sites-available/frigate-redirect.conf(copie danshttps/, modulesrewriteetssl).http://192.168.1.247/(port 80) ethttps://192.168.1.247/(port 443, avec le même certificat que Frigate), ainsi que.243,frigate…, redirigent vershttps://<même nom>:8971/. Le port 443 a été ajouté parce que Firefox 140 essaie d'abord le HTTPS sur le port 443 : sans lui, on obtenait « la connexion a échoué ». Le site par défaut d'Apache (page « It works »,localhost) est inchangé. - Le nom
frigate.pcstreet.orga été ajouté le 2026-10-09 à 17:34, hors de cette session, sous la forme d'une deuxième ligneServerName. Pour Apache, seule la dernière ligneServerNamecompte :192.168.1.247ne correspondait plus et tombait sur la page par défaut. Corrigé :frigate.pcstreet.orgest passé enServerAlias. Règle : un seulServerName, les autres noms enServerAlias. Remarque :frigate.pcstreet.orgn'est pas dans le certificat (à ajouter dansfrigate.cnfsi ce nom est utilisé).
Vérifications du 2026-10-09 :
curl --cacert /opt/frigate/https/ca.crt -o /dev/null -w "%{http_code} %{ssl_verify_result}\n" https://192.168.1.247:8971/ # 200 0
curl -o /dev/null -w "%{http_code} %{redirect_url}\n" http://192.168.1.247/ # 302 https://192.168.1.247:8971/
curl --cacert /opt/frigate/https/ca.crt -o /dev/null -w "%{http_code} %{redirect_url}\n" https://192.168.1.247/ # 302 https://192.168.1.247:8971/
Installer l'autorité sur un appareil
Fichier à importer : /opt/frigate/https/ca.crt (public, on peut le copier partout). Ne jamais diffuser ca.key.
| Appareil | Méthode | État |
|---|---|---|
| srv18 (Firefox ESR 140, Debian) | Politique Firefox (Certificates.Install, qui pointe vers /usr/local/share/ca-certificates/frigate-maison.crt) dans /usr/lib/firefox-esr/distribution/policies.json et dans /etc/firefox-esr/policies/policies.json, plus le magasin système (update-ca-certificates). Firefox ne lit les politiques qu'au démarrage : le 2026-10-09, il tournait sans interruption depuis le 29 septembre, d'où l'avertissement persistant. Sans redémarrer Firefox : Paramètres → Vie privée et sécurité → Certificats → Afficher les certificats → Autorités → Importer, choisir le fichier, puis cocher « Confirmer cette AC pour identifier des sites web » |
fait (pris en compte au prochain démarrage de Firefox) |
| PC Windows (192.168.1.218) | Double-cliquer sur ca.crt, puis Installer le certificat → Ordinateur local → magasin Autorités de certification racines de confiance. Pour Firefox : Paramètres → Vie privée et sécurité → Certificats → Afficher les certificats → Autorités → Importer |
à faire |
| Android | Paramètres → Sécurité → Chiffrement et identifiants → Installer un certificat → Certificat CA | à faire |
| iPhone / iPad | Ouvrir ca.crt (profil), l'installer, puis Réglages → Général → Informations → Réglages des certificats : activer la confiance totale |
à faire |
Renouvellement (avant le 11 janvier 2029)
cd /opt/frigate/https openssl genrsa -out frigate/privkey.pem 2048 openssl req -new -key frigate/privkey.pem -config frigate.cnf -out frigate.csr openssl x509 -req -in frigate.csr -CA ca.crt -CAkey ca.key -CAcreateserial -days 825 -sha256 \ -extfile frigate.cnf -extensions ext -out frigate/cert.pem cat frigate/cert.pem ca.crt > frigate/fullchain.pem # recharger le certificat SANS redémarrer Frigate (nginx interne seulement) : docker exec frigate /usr/local/nginx/sbin/nginx -s reload systemctl reload apache2 # Apache utilise aussi ce certificat (port 443)
Pour ajouter un nom ou une adresse : compléter subjectAltName dans frigate.cnf, puis refaire le certificat (même commande). L'autorité, elle, ne change pas : les appareils n'ont pas besoin d'être reconfigurés.
Revenir au certificat auto-signé
Supprimer la ligne ./https/frigate:/etc/letsencrypt/live/frigate:ro de docker-compose.yml, puis docker compose up -d frigate.
Sauvegarde et restauration
Sauvegarde complète : sauvegarder.sh
Depuis le 2026-10-12, /opt/frigate/sauvegarde/sauvegarder.sh fait en une commande tout ce qu'il faut pour redémarrer après un crash de 5050 ou de srv18 (environ 1 min 10 s, archive d'environ 860 Mo) :
opt/frigate/: tout/opt/frigatesaufstorage/: configuration, secrets (.env,identifiants.txt,.jwt_secret,passwdMQTT, clés HTTPS), scripts, modèles (config/model_cache/: YOLOv9 et modèles de classification), dépôt git ;frigate.db: copie cohérente faite à chaud (API de sauvegarde de SQLite, sans arrêter Frigate), avec contrôle d'intégrité ;systeme/:/etc/fstab,/etc/hosts, site Apachefrigate-redirect.conf, minuteries et servicesfrigate-*, crontab de root ;donnees-apprises/: ce qui est sur srv18 et ne se recrée pas : visages (clips/faces), images des modèles de classification (clips/chiens,chats,voitures), script et identifiants de l'e-mail des time-lapses, photos de fond ;srv18/:/etc/cron.d/sendTimeLapseOfTheDay,/etc/exports,/etc/hostsde srv18 ;versions.txt: version de Frigate et empreintes des images Docker (pour réinstaller exactement la même version) ;LISEZMOI.txt: marche à suivre pour la restauration.
Ne sont pas sauvegardés : les vidéos (enregistrements, time-lapses), trop volumineuses et inutiles au redémarrage.
Deux copies, une sur chaque machine : /var/backups/frigate/ (5050) et /data/sauvegardes/frigate/ (srv18), vérifiées par leur empreinte SHA-256. On garde les 7 plus récentes de chaque côté (GARDER). Archives lisibles par root seulement (elles contiennent les secrets). Journal : sauvegarde/sauvegarde.log.
/opt/frigate/sauvegarde/sauvegarder.sh | tee -a /opt/frigate/sauvegarde/sauvegarde.log
Première sauvegarde : 2026-10-12 à 12:10 (frigate-sauvegarde-20261012-121023.tar.gz, 856 Mo), ouverte et vérifiée : secrets présents, base intègre (71 détections).
Restaurer : ouvrir l'archive (tar -xzf frigate-sauvegarde-….tar.gz) et suivre son LISEZMOI.txt (voir aussi « Restauration sur une nouvelle machine » ci-dessous).
Ce qu'il faut sauvegarder
Tout Frigate se trouve dans /opt/frigate. Les conteneurs ne montent que des dossiers de /opt/frigate, plus /etc/localtime (fuseau horaire du système) et un espace en mémoire vive (tmpfs) pour le cache. Il n'y a aucun volume Docker. Vérification :
docker inspect -f '{{range .Mounts}}{{.Type}} {{.Source}} -> {{.Destination}}{{"\n"}}{{end}}' frigate mosquitto
docker volume ls
| Élément | À sauvegarder ? | Remarque |
|---|---|---|
docker-compose.yml, config/config.yml, mosquitto/config/ |
Oui | Aussi versionnés dans git |
.env, identifiants.txt, config/.jwt_secret, config/notifications.pem, mosquitto/config/passwd, https/ca.key, https/frigate/privkey.pem |
Oui | Secrets, exclus de git : uniquement dans la sauvegarde. Attention aux outils qui ignorent les fichiers cachés (dont le nom commence par un point) |
config/frigate.db (+ -wal, -shm) |
Oui | Base de Frigate : utilisateurs, événements, descriptions IA. Voir ci-dessous |
.git/ |
Oui | Historique des modifications |
verificateur/data/ |
Conseillé | Historique des verdicts et captures des faux positifs (hors git) |
storage/ (sur srv18) |
Facultatif | Enregistrements vidéo et captures, plus les visages appris (clips/faces/, à sauvegarder). Ces données sont sur srv18 : à sauvegarder là-bas (/data/frigate) : plusieurs dizaines de Go avec 7 à 14 jours de conservation
|
config/model_cache/ |
Facultatif | Environ 350 Mo, retéléchargé automatiquement s'il manque |
mosquitto/data/, mosquitto/log/ |
Facultatif | Messages conservés par le broker et journaux |
Base de données : frigate.db est modifiée en permanence. Pour une copie cohérente :
cd /opt/frigate docker compose stop frigate # quelques secondes # ... lancer la sauvegarde de /opt/frigate ... docker compose start frigate
À défaut, il faut au minimum copier ensemble frigate.db, frigate.db-wal et frigate.db-shm.
Ce qu'il est inutile de sauvegarder
- Les images Docker (
/var/lib/docker) :docker compose pullles retélécharge. Attention : l'image utilisée estfrigate:stable, donc une restauration ultérieure peut installer une version plus récente que la 0.18.0 installée. Pour l'éviter, indiquer une version précise dansdocker-compose.yml. - Docker lui-même : il se réinstalle avec
apt install docker.io docker-compose.
Fichiers système (hors /opt/frigate)
/etc/fstab: montage NFSsrv18:/data/frigate→/opt/frigate/storage(voir « Stockage sur srv18 »). Sur srv18 :/etc/exports./etc/apache2/sites-available/frigate-redirect.conf(redirection vers le HTTPS ; copie danshttps/apache-frigate-redirect.conf). À restaurer aveccp /opt/frigate/https/apache-frigate-redirect.conf /etc/apache2/sites-available/frigate-redirect.conf && a2enmod rewrite && a2ensite frigate-redirect && systemctl reload apache2./etc/systemd/system/frigate-alerte.service(une copie se trouve dansdeclencheur/)./etc/systemd/system/frigate-timelapse.{service,timer}etfrigate-timelapse-capture.{service,timer}(copies danstimelapse/). À restaurer aveccp /opt/frigate/declencheur/frigate-alerte.service /etc/systemd/system/ && systemctl daemon-reload && systemctl enable --now frigate-alerte.- Paquet
mosquitto-clients(apt install mosquitto-clients).
Éléments liés, stockés ailleurs
- hal (192.168.1.111) :
/data/ai/models.ini,/etc/systemd/system/llama-server.service.d/override.confet/data/ai/HAL-setup.md. Des copies de référence se trouvent dans/opt/frigate/hal/. Le modèle (environ 6 Go) se retélécharge. - Caméra Vivotek : ses réglages (heure, NTP, flux…) sont stockés dans la caméra. Son interface web permet de les exporter.
Restauration sur une nouvelle machine
apt install docker.io docker-compose # restaurer /opt/frigate, fichiers cachés compris chown -R 1883:1883 /opt/frigate/mosquitto/data /opt/frigate/mosquitto/log /opt/frigate/mosquitto/config/passwd cd /opt/frigate && docker compose up -d docker logs frigate 2>&1 | grep TPU # « TPU found » (sinon : docker restart frigate)
Si l'adresse IP change, il faut mettre à jour la configuration de Home Assistant (broker MQTT, intégration Frigate).
Sauvegarde par OutBackup3 (srv18)
OutBackup3 (PCStreet), sur srv18 (192.168.1.18), copie les fichiers par rsync sur SSH, en root. Le 2026-10-09, une copie de /opt lancée depuis srv18 en simulation (rsync -an root@192.168.1.243:/opt/ …) s'est déroulée sans erreur (540 fichiers, 1,1 Go). L'échec signalé vient donc d'OutBackup3 lui-même ou de sa destination, et reste à diagnostiquer avec le message d'erreur affiché. Point à vérifier : la machine a deux adresses (192.168.1.247 en filaire, 192.168.1.243 en Wi-Fi), ce qui peut perturber la vérification de l'identité SSH.
Sécurité
- Le mot de passe
admingénéré automatiquement a été changé le 2026-10-09. - Fermez le port 5000 s'il n'est pas utilisé, ou limitez-le au réseau local par un pare-feu. Attention : l'intégration Home Assistant décrite plus haut utilise ce port.
- La caméra n'a aucun mot de passe : n'importe qui sur le réseau local peut voir le flux vidéo et modifier ses réglages (
/cgi-bin/admin/). Il faut définir un mot de passerootdans l'interface de la Vivotek, puis mettre à jour les URL dansconfig.yml. - Le broker MQTT refuse les connexions anonymes. Le mot de passe se trouve dans
/opt/frigate/.env, qu'il ne faut pas diffuser.
Prochaines étapes
| # | Action | Quand |
|---|---|---|
| 1 | Tester la zone : Paramètres → Débogage, traverser le jardin, vérifier le cadre, l'entrée dans zone_active, puis l'alerte dans Activités → Alertes avec sa description IA |
Maintenant |
| 2 | Revoir le masque d'exclusion si l'on veut repérer les personnes dès le fond du jardin (le réduire au feuillage) | Selon le besoin |
| 3 | Laisser tourner quelques jours, puis relever les fausses détections dans Explore : à un endroit fixe → masque d'objet ; un peu partout → monter threshold / min_score |
Après quelques jours |
| 4 | Connecter Home Assistant : intégration MQTT, puis intégration Frigate via HACS (voir plus haut). Créer de préférence un compte MQTT dédié avec changer-mdp-mqtt.sh homeassistant |
Quand Home Assistant sera installé |
| 5 | Sécuriser la caméra : la Vivotek n'a aucun mot de passe, même pour l'administration (/cgi-bin/admin/). Définir un mot de passe root sur la caméra, puis mettre à jour les URL dans config.yml (section go2rtc) |
Prioritaire |
| 19 | Supprimer /opt/frigate/storage.old (20 Go) après quelques jours sans problème avec le stockage sur srv18 |
Vers le 2026-10-16 |
| 18 | HTTPS : importer https/ca.crt sur les autres appareils (PC Windows, téléphones) ; renouveler le certificat avant le 11 janvier 2029 |
Selon les appareils / 2028 |
| 6 | Fermer le port 5000 s'il n'est pas utilisé (attention : l'intégration Home Assistant s'en sert) | Conseillé |
| 13 | Mesurer l'espace occupé sur srv18 après les changements du 2026-10-10 (encodage VBR, active_objects) : du -sh /opt/frigate/storage/* ; vérifier aussi les time-lapses de la nuit |
2026-10-12 puis 2026-10-16 |
| 14 | Reolink : zones et masques : zone garage_cour dessinée par Patrick (toute la cour au premier plan) ; alertes liées à cette zone depuis le 2026-10-10 (review.alerts.required_zones: [garage_cour]) ; masque « haut des arbres » à ajuster si besoin |
fait le 2026-10-10 |
| 15 | Reolink : stockage : choisir un stockage externe (NFS ou SMB, pas FTP) ou un disque, si l'on veut de l'enregistrement continu | À décider |
| 17 | YOLOv9 : vérifier sur les prochains jours les détections (personnes, voitures, Tommy, Camel) et les fausses alertes ; ajuster les seuils si besoin (le seuil person reste à 0,75) |
Prochains jours |
| 16 | Reolink : téléobjectif et suivi automatique (flux Preview_02, ONVIF port 8000) : à intégrer si besoin |
Plus tard |
| 7 | Vérifier la synchronisation NTP de la caméra : l'heure a été corrigée le 2026-10-09 (voir Dépannage). Contrôler dans quelques jours que l'horodatage incrusté est toujours à l'heure | Dans quelques jours |
| 8 | Envisager Frigate+ si les réglages ne suffisent pas (les captures de verificateur/data/faux_positifs/ peuvent y être envoyées) |
Plus tard |
| 9 | Surveiller le vérificateur la nuit (infrarouge non testé) : vérifier dans verifications.jsonl qu'aucune vraie personne n'est classée en faux positif |
Prochaines nuits |
| 11 | Compléter son visage : 8 images de jour déjà apprises (collection Patrick) ; ajouter des images de nuit et de trois quarts | Prochains passages |
| 12 | Tommy : vérifier qu'un passage seul crée un événement « dog », puis créer le modèle de classification « Tommy » | Prochains jours |
| 10 | Notifications Home Assistant : utiliser frigate_verif/vivotek/alerte et non frigate/reviews |
À la mise en place de Home Assistant |
Références
- Documentation Frigate : https://docs.frigate.video
- IA générative dans Frigate : https://docs.frigate.video/configuration/genai
- Configuration du Coral : https://docs.frigate.video/configuration/object_detectors#edge-tpu-detector
- Intégration Home Assistant : https://docs.frigate.video/integrations/home-assistant
- Sujets MQTT de Frigate : https://docs.frigate.video/integrations/mqtt
- Zones : https://docs.frigate.video/configuration/zones
- Masques : https://docs.frigate.video/configuration/masks