Installation

Litmus NVR läuft unter Windows, macOS und auf vielen Linux-Geräten wie Raspberry Pi, Jetson und Radxa. Alle Installationsdateien findest du auf der Downloadseite.

Unterstützte Einplatinencomputer sind Raspberry Pi 3/4/5 und Zero 2 e, NVIDIA Jetson (Nano, Orin Nano, AGX Orin) sowie Radxa Rock (5A, 5B, 5C, Zero 3e).

Windows und macOS

Lade das Installationsprogramm (Windows: .exe, macOS: .pkg) von der Downloadseite herunter, führe es aus und folge den Anweisungen. Litmus startet automatisch, sobald die Installation abgeschlossen ist.

Vorinstalliertes Image (Raspberry Pi)

Schreibe ein Raspberry Pi OS-Image mit vorinstalliertem Litmus auf eine SD-Karte. Litmus startet beim Hochfahren automatisch als Systemdienst. Das ist die einfachste Option für Einsteiger. Es gibt ein vollständiges Image mit Desktop und ein Lite-Image nur mit Befehlszeile.

Die heruntergeladene Image-Datei (.img.xz) lässt sich auch mit allgemeinen Image-Schreibprogrammen wie balenaEtcher schreiben. Wir empfehlen jedoch Raspberry Pi Imager, weil du damit beim Schreiben der Karte WLAN und das Benutzerkonto einrichten kannst. Die folgenden Schritte und Bildschirme beziehen sich auf Raspberry Pi Imager 1.9. Wähle bei der Auswahl des Betriebssystems Eigenes Image und dann die Image-Datei aus.

Wähle unter „Speicher“ die SD-Karte aus, auf die geschrieben werden soll, und klicke auf Weiter. Ein Dialog fragt, ob Einstellungen zur Anpassung des Betriebssystems angewendet werden sollen.

Wähle in diesem Dialog Einstellungen bearbeiten, um Hostname, Benutzerkonto, WLAN und Gebietsschema vorab festzulegen. Bei einer Einrichtung ohne Monitor und ohne Ethernet musst du unbedingt das WLAN konfigurieren. Wenn du die Einstellungen nicht bearbeitet hast, lautet die Standardanmeldung für Raspberry Pi OS litmus / litmus.

Wenn du auf dem Tab Dienste SSH aktivierst, kannst du das Gerät ohne Monitor über das Netzwerk erreichen. Klicke anschließend auf Speichern, kehre zum Dialog zur Anpassung des Betriebssystems zurück und klicke auf Ja. Bestätige die Warnung, dass vorhandene Daten auf der SD-Karte gelöscht werden. Danach beginnt der Schreibvorgang.

Wenn der Schreibvorgang abgeschlossen ist, setze die SD-Karte in den Raspberry Pi ein und schließe den Strom an. Litmus startet bei jedem Hochfahren automatisch als Systemdienst, ohne dass eine Anmeldung nötig ist.

Home Assistant-Add-on

Unter Home Assistant OS oder Supervised installierst du Litmus als Add-on. Das Add-on verbindet sich automatisch mit Home Assistant, ohne manuelle Hardwareeinrichtung.

1. Öffne in Home Assistant Einstellungen > Apps > App Store und füge https://github.com/grablo/litmus-hass-addons im Menü oben rechts unter Repositorys hinzu. Wenn du auf die Schaltfläche unten klickst, wird der Repository-Dialog direkt geöffnet.
2. Suche im Store nach Litmus NVR und klicke auf Installieren.
3. Wenn die Installation abgeschlossen ist, klicke auf Starten.

Sobald das Add-on läuft, öffne den lokalen Bildschirm in einem Browser im selben Netzwerk unter http://<Home Assistant IP address>:8128. Der Einrichtungscode, den du beim ersten Öffnen brauchst, wird beim ersten Start des Add-ons auf dessen Tab Protokoll angezeigt. Details findest du unter Lokalen Bildschirm öffnen.

Docker

Auf Mini-PCs, NAS und anderen Docker-Hosts installierst du Litmus als Container. Wenn du Home Assistant OS oder Supervised verwendest, empfehlen wir stattdessen das oben beschriebene Add-on.

git clone https://github.com/grablo/litmus-docker.git
cd litmus-docker
docker compose up -d

Sobald der Container läuft, öffne den lokalen Bildschirm in einem Browser im selben Netzwerk unter http://<Docker host IP address>:8128. Mit docker exec litmus cat /etc/litmus/local/setup_code.txt findest du den Einrichtungscode, den du beim ersten Öffnen brauchst.

Identität und Daten werden in benannten Volumes gespeichert. Der Container bleibt daher über Updates und Neuerstellung hinweg dasselbe Gerät. Der Container aktualisiert sich nicht selbst. Installiere eine neue Version mit docker compose pull und anschließend docker compose up -d. Details findest du in der Installationsanleitung.

Direkte Installation (.deb)

Wer sich mit Linux auskennt, kann das .deb-Paket für die passende Architektur (ARM64/x64) herunterladen und direkt installieren. Auf einem Desktop öffnest du die .deb-Datei zur Installation im Dateimanager. Über die Befehlszeile kopierst du das Paket auf das Gerät und führst sudo apt install -y ./litmus-nvr*.deb aus. Nach der Installation startet Litmus als Systemdienst und wird beim Hochfahren automatisch gestartet, ohne dass eine Anmeldung nötig ist.