Community-Lösung

Frigate auf CasaOS installieren: Das Google-Coral-Tutorial von 2023 für die aktuelle Docker-Compose-Version aktualisieren

A September 2023 Community post promoting an external Frigate-on-CasaOS tutorial focused on Google Coral object detection. The forum body does not preserve the Compose file or exact configuration, so a current article must use maintained Frigate documentation rather than reconstructing the old video steps.

Der Ausgangs-Thread ist eine Einführung in ein externes Tutorial aus dem Jahr 2023 und keine vollständige Dokumentation einer Frigate-Bereitstellung. Er besagt, dass das Tutorial Frigate auf CasaOS installiert und Kameras mit Google Coral integriert, enthält jedoch nicht das damals verwendete Docker-Image, die Volumes, Ports, die Größe des Shared Memory oder die Detektorkonfiguration.

Für eine aktuelle Einrichtung sollte die gepflegte Dokumentation von Frigate als technische Grundlage dienen. Docker Compose bleibt die empfohlene Installationsmethode, und Google Coral ist inzwischen nur noch eine von mehreren möglichen Optionen für Hardwarebeschleunigung sowie Detektor- und Videopfade.

Frigate empfiehlt aktuell Docker Compose

Die aktuelle Installationsanleitung von Frigate verwendet ghcr.io/blakeblackshear/frigate:stable, eine persistente Konfiguration und Medien, eine explizit festgelegte Größe des Shared Memory sowie Gerätemappings, die zum ausgewählten Beschleuniger passen.

Verwende das aktuelle Frigate-Installationsmodell, anstatt ein Video aus dem Jahr 2023 wortgetreu zu kopieren.

/config außerhalb des Containers persistent speichern

Die YAML-Konfiguration von Frigate gehört in einen Host-Ordner, der auf /config gemountet wird. Speichere sie auf dauerhaftem CasaOS-Speicher, damit beim Neuerstellen des Containers keine Einstellungen für Kameras, Detektoren, Aufnahmen, Zonen und Schnappschüsse verloren gehen.

Aufnahmen und Clips auf echten Speicher mounten

NVR-Videos können deutlich schneller wachsen als gewöhnliche App-Daten. Lege Aufnahmen, Clips und Exporte auf einem Speicher-Volume mit ausreichender Kapazität ab, statt auf der kleinen Systemfestplatte.

Der Shared Memory muss zur Kamerabelastung passen

Frigate verwendet Shared Memory für die Videoverarbeitung. Das aktuelle Compose-Beispiel enthält eine explizite Angabe für shm_size; der richtige Wert hängt von Auflösung und Anzahl der Kameras ab.

Google Coral ist optional und keine allgemeine Voraussetzung

Die Quelle aus dem Jahr 2023 legte den Schwerpunkt auf Google Coral. Frigate dokumentiert weiterhin USB- und PCIe-Coral-Mappings, moderne Bereitstellungen können je nach Hardware jedoch auch Intel-/AMD-Videobeschleunigung, Intel NPU oder andere unterstützte Detektorpfade verwenden.

Hardwarebeschleunigung erfordert das richtige Gerätemapping

Aktuelle Beispiele enthalten /dev/bus/usb für USB Coral, /dev/apex_0 für PCIe Coral, /dev/dri/renderD128 für Intel-/AMD-Grafik und /dev/accel für unterstützte Intel-NPU-Pfade. Gewähre nur Zugriff auf die Hardware, die Frigate tatsächlich benötigt.

Der privilegierte Modus ist nicht immer erforderlich

Das aktuelle Compose-Beispiel von Frigate weist darauf hin, dass privileged: true nicht für alle Setups notwendig ist. Wenn explizite Gerätemappings und Berechtigungen ausreichen, ist das Prinzip der geringsten Rechte vorzuziehen.

Kamera-Zugangsdaten und RTSP-Endpunkte privat halten

Die Frigate-Konfiguration enthält häufig Benutzernamen, Passwörter und RTSP-URLs von Kameras. Veröffentliche keine vollständigen Konfigurationsdateien oder Screenshots, ohne Geheimnisse zu schwärzen, und stelle RTSP nicht direkt ins Internet.

CasaOS ist der Container-Host, nicht die Frigate-Konfigurationsebene

CasaOS kann den Container starten und Speicher sowie Geräte mounten, während die YAML-Datei von Frigate das NVR-Verhalten steuert. Wenn die App geöffnet wird, aber Kameras fehlschlagen, solltest du die Frigate-Logs und -Konfiguration prüfen, anstatt CasaOS wiederholt neu zu installieren.

Objekterkennung und Videodecodierung sind unterschiedliche Beschleunigungsaufgaben

Ein Coral-Beschleuniger wird für unterstützte Inferenz zur Objekterkennung verwendet; Intel-/AMD-/NVIDIA-Videohardware kann Decodierung und Codierung beschleunigen. Das eine ersetzt nicht automatisch das andere.

Plane den Frigate-Stack sowohl anhand der Detektorbelastung als auch anhand der Kamera-Codec- und Transkodierungsbelastung, anstatt „Hardwarebeschleunigung“ als eine einzige Option zu betrachten.

Aufbewahrungsfristen festlegen, bevor viele Kameras aktiviert werden

Kontinuierliche Aufnahmen können Festplatten schnell füllen. Schätze Bitrate × Kameraanzahl × Aufbewahrungstage, lasse ausreichend freien Speicher auf dem Dateisystem und entscheide, welche Ereignisse lange aufbewahrt werden müssen und welche Aufnahmen einem rollierenden Speicherzyklus unterliegen.

Nach dem ersten Start Frigate-Logs und Gesundheitszustand prüfen

Bevor du jede Kamera hinzufügst, validiere einen Stream, bestätige, dass der Detektor bzw. das Gerät erkannt wird, und prüfe die Container-Logs auf Fehler im Zusammenhang mit Shared Memory, FFmpeg oder Berechtigungen. Eine bekannte, funktionierende Kamera zu skalieren ist einfacher, als fünf Fehler gleichzeitig zu beheben.

FAQ: Frigate auf CasaOS

Enthält der ursprüngliche Community-Beitrag die vollständige Frigate-Compose-Datei?

Nein. Er verweist hauptsächlich auf ein externes Tutorial aus dem Jahr 2023.

Ist Google Coral für die aktuelle Version von Frigate zwingend erforderlich?

Nein. Coral bleibt eine unterstützte Option, aber die aktuelle Version von Frigate unterstützt je nach Host auch andere Hardwarepfade.

Was sollte immer persistent gespeichert werden?

Mindestens die Frigate-Konfiguration sowie der Medien- und Aufnahmespeicher, den du behalten möchtest.