--- url: /de/home-assistant/app.md --- # Home-Assistant-App Du kannst den vollen camera.ui-Server als App direkt in Home Assistant OS laufen lassen. Im Repository stecken zwei Apps: **camera.ui**, der volle Server mit eigenem Panel in der Home-Assistant-Seitenleiste, und **camera.ui Worker**, ein Helfer, der die Rechenleistung dieser Maschine einem camera.ui-Server woanders leiht. Beide laufen auf `amd64`- und `aarch64`-Hosts. ## Installation 1. Öffne in Home Assistant **Einstellungen → Apps → App-Store**. 2. Wähle im Menü des Stores (oben rechts) **Repositories** und füge `https://github.com/cameraui/homeassistant-apps` hinzu. 3. Such **camera.ui** im Store und klick auf **Installieren**. ## Das camera.ui-App Das **camera.ui**-App startet den kompletten Server: die UI, die Streaming-Engine, den NVR und alle Plugins, die du installierst. Es läuft im Host-Netzwerk, das es für WebRTC-Livebild, HomeKit-Pairing und Kamera-Erkennung braucht. Nach dem Start legt das App einen Eintrag **camera.ui** in der Home-Assistant-Seitenleiste an. Dieses Panel und der Button **Web-UI öffnen** des Apps öffnen die Oberfläche beide über den Ingress-Proxy von Home Assistant, also ohne zweiten Login und ohne Zertifikatswarnung.\[^direct] Beim **ersten Start** lädt das App den camera.ui-Server und das Standard-Plugin herunter, was eine Internetverbindung braucht und ein paar Minuten dauert.\[^firstboot] Den ersten Boot kannst du im Tab **Log** des Apps mitverfolgen. \[^direct]: Das App hört auch direkt unter `https://:3443` im Host-Netzwerk. Dieser Weg zeigt einmalig eine Warnung wegen des selbstsignierten Zertifikats. \[^firstboot]: Wenn der erste Boot den Server nicht laden kann, prüf, ob der Host das Internet erreicht und DNS auflöst. ## Optionen * **default\_plugins.** Komma-getrennte Plugins, die beim ersten Boot installiert werden. Standard ist `@camera.ui/camera-ui-nvr`, das NVR-Plugin. * **recordings\_path.** Wohin das NVR-Plugin Aufnahmen schreibt. Standard ist `/media/camera.ui`. Pfade unter `/media` tauchen im Medien-Browser von Home Assistant auf. * **internal\_avahi.** Startet den eigenen mDNS-Stack des Apps für HomeKit-Pairing und Kamera-Erkennung. Standardmäßig an. Schalt es aus, um stattdessen das mDNS des Hosts zu nutzen. ## Hardwarebeschleunigung Das App reicht GPU-, KI-Beschleuniger- und Codec-Geräte in den Container durch. * **Intel / AMD (VA-API).** VA-API-Treiber sind nur bei `amd64` dabei und decken Intel Quick Sync und AMD Mesa VA-API ab. `aarch64`-Hosts bekommen kein VA-API. * **Coral Edge TPU.** Die Coral-Runtime ist für beide Architekturen enthalten. USB-Coral läuft über den USB-Zugriff des Apps, PCIe-Coral über die durchgereichten `/dev/apex_*`-Geräte. * **Hailo.** Das Hailo-Gerät (`/dev/hailo0`) wird durchgereicht, die Hailo-Runtime ist aber nicht Teil des Images.\[^hailo] * **NVIDIA.** Im Home-Assistant-App nicht verfügbar. Für ein NVIDIA-Setup nimm [Docker](/de/install/docker) auf einem normalen Linux-Host. Die Seite [Hardwarebeschleunigung](/de/install/hardware-acceleration) erklärt, wie die Streaming-Engine ein Gerät wählt und wie du prüfst, dass es funktioniert. \[^hailo]: Installier das Hailo-Plugin, um die Runtime zu ergänzen. Das App-Image selbst reicht nur das Gerät durch. ## Aufnahmen und der Medien-Browser Das Verzeichnis `/media` ist mit Schreibrechten ins App eingebunden. Mit dem Standard-`recordings_path` `/media/camera.ui` erscheinen die Aufnahmen des NVR im **Medien**-Browser von Home Assistant. ## Backups und Updates Home Assistant sichert das Verzeichnis `/data` des Apps, in dem Konfiguration, Datenbank und TLS-Zertifikate liegen. Drei Unterbäume sind vom Backup **ausgeschlossen**: der heruntergeladene Server, die Python-Umgebung und die installierten Plugins. Die werden beim Wiederherstellen neu geladen, also braucht ein Restore eine Internetverbindung, genau wie ein erster Start. Der Server aktualisiert sich aus der App heraus, alltägliche Updates brauchen also kein neues App-Image. Aktualisier das App selbst, wenn eine neue Version veröffentlicht wird, um das Basis-Image (OS, Treiber und Launcher) zu erneuern. Lass den **Watchdog** des Supervisors für das App an, damit Home Assistant es neu startet, falls es unerwartet stoppt.\[^watchdog] \[^watchdog]: Watchdog ist eine Home-Assistant-Einstellung auf der Info-Seite des Apps, keine Option von camera.ui. ## Worker-App Das **camera.ui Worker**-App macht diese Home-Assistant-Maschine zu einem [Worker](/de/admin/workers) für einen camera.ui-Server (den Master), der woanders läuft. Es leiht dem Master CPU, GPU und Coral dieser Maschine für Decoding, Erkennung und Plugins. Es hat keine eigene UI und kein Seitenleisten-Panel und verbindet sich nach außen zum Master. Es reicht dieselbe Hardware durch wie das volle App. Richte es zuerst am Master ein, dann hier: 1. Aktivier am **Master** die Worker und setz die Master-Adresse, dann erzeug einen einmaligen Pairing-Code. Das Erzeugen eines Codes und das Pairing schlagen fehl, solange die Worker dort nicht aktiviert sind. Siehe [Workers](/de/admin/workers). 2. Installier das **camera.ui Worker**-App auf dieser Maschine. 3. Setz **master\_address** auf die IP oder den Hostnamen des Masters und **pairing\_code** auf den eben erzeugten Code. 4. Start das App. Es tauscht den Code beim ersten Verbinden gegen eigene Zugangsdaten und verbindet sich danach von selbst wieder, der Code wird also nur einmal eingegeben. * **master\_address.** IP oder Hostname des camera.ui-Masters. Erforderlich. * **pairing\_code.** Der einmalige Code, der am Master erzeugt wird. Für die erste Verbindung erforderlich. Ein Code ist 15 Minuten gültig und lässt sich einmal verwenden. * **worker\_name.** Name, unter dem dieser Worker am Master angezeigt wird. Optional. Standard ist `worker`. * **master\_api\_port.** Der HTTPS-API-Port des Masters. Optional. Standard ist `3443`. ## Nächste Schritte * **[Hardwarebeschleunigung](/de/install/hardware-acceleration)** — wie die Streaming-Engine GPU und Beschleuniger nutzt und wie du es prüfst. * **[Workers](/de/admin/workers)** — das ganze Bild aus Master, Workern und Kamera-Zuweisungen. * **[Docker](/de/install/docker)** — den Server außerhalb von Home Assistant betreiben, inklusive NVIDIA-Setups.