Community-Lösung

So richtest du Jellyfin, Seerr und JellyBridge auf ZimaOS ein

A ZimaOS user had Jellyfin running from the App Store but struggled to add Seerr and JellyBridge. Community replies clarified that Seerr is a separate service, JellyBridge is a Jellyfin plugin, and Docker connectivity must be tested layer by layer.

Jellyfin, Seerr und JellyBridge sind nicht drei Bestandteile einer einzigen ZimaOS-App. Der IceWhale-Community-Thread vom Juni 2026 wurde verständlicher, sobald der Stack in Ebenen aufgeteilt wurde: Jellyfin ist der Medienserver, Seerr eine eigenständige Anwendung für Medienanfragen und JellyBridge ein Jellyfin-Plugin, das die Entdeckungs- und Anfragefunktionen von Jellyfin mit Seerr verbindet.

Der ursprüngliche Verfasser hatte Jellyfin bereits aus dem ZimaOS App Store installiert, konnte jedoch den restlichen Stack nicht zum Laufen bringen. Community-Antworten empfahlen, jede Ebene unabhängig zu untersuchen, statt alles gleichzeitig zu ändern. Ein späterer Nutzer bestätigte, dass Jellyfin und Seerr erfolgreich auf einem ZimaBoard 2 liefen, während sein Sonarr/Radarr-Stack auf einem separaten Raspberry Pi lief. Das zeigt, dass diese Dienste weder im selben Container noch auf demselben Gerät laufen müssen, solange URLs, API-Zugangsdaten und Netzwerkrouten korrekt sind.

Verstehen Sie zuerst den Jellyfin-→-Seerr-→-JellyBridge-Stack

Am einfachsten lässt sich die Einrichtung so verstehen:

  • Jellyfin: stellt Ihre vorhandenen Film- und TV-Bibliotheken bereit und verwaltet sie.
  • Seerr: ermöglicht die Entdeckung von Inhalten und Medienanfragen und sendet anschließend genehmigte Anfragen an Sonarr und Radarr.
  • Sonarr/Radarr: übernehmen die Workflows für die Beschaffung von Fernsehserien und Filmen.
  • JellyBridge: läuft als Plugin innerhalb von Jellyfin und kommuniziert mit Seerr, sodass Entdeckungen oder Favoriten in Jellyfin Anfragen erstellen können.

Die aktuelle Seerr-Dokumentation beschreibt Seerr als Manager für Medienanfragen und -entdeckung für Jellyfin, Plex und Emby mit nativer Integration von Sonarr und Radarr. Seerr läuft normalerweise in einem eigenen Docker-Container und stellt seine Weboberfläche auf Port 5055 bereit. Siehe den aktuellen Leitfaden für die ersten Schritte mit Seerr.

Seerr ist der aktuelle Nachfolger von Jellyseerr und Overseerr

In einer Community-Antwort wurde darauf hingewiesen, dass Seerr die ältere Jellyseerr-Anwendung ersetzt hatte. Die aktuelle Projektdokumentation von Seerr bestätigt, dass Seerr der gemeinsame Nachfolger für Nutzer von Jellyseerr und Overseerr ist.

Das ist wichtig, weil in älteren JellyBridge-Dokumentationen, Screenshots, Umgebungsvariablen oder Containernamen möglicherweise noch Jellyseerr steht. Im aktuellen JellyBridge-Projekt heißt es, dass Seerr 3.x für die getestete Integration eine kompatible API verwendet, während Teile der Dokumentation weiterhin die Jellyseerr-Terminologie nutzen.

Wenn Sie diesen Stack jetzt erstellen, beginnen Sie mit der aktuellen Seerr-Version, statt absichtlich eine veraltete Jellyseerr-Version zu installieren, es sei denn, eine bestimmte Plugin-Version erfordert dies ausdrücklich.

Schritt 1: Seerr zum Laufen bringen, bevor Sie JellyBridge installieren

Beheben Sie keine Probleme mit JellyBridge, bevor Seerr selbst ordnungsgemäß funktioniert. Installieren Sie Seerr als separate ZimaOS-Docker-Anwendung oder über die auf Ihrem aktuellen System unterstützte App-Quelle.

Überprüfen Sie nach der Installation die Seerr-Weboberfläche direkt:

http://ZIMAOS_LAN_IP:5055

Der Host-Port kann abweichen, wenn Ihre ZimaOS-Containerzuordnung einen anderen externen Port verwendet. Verwenden Sie den Host-seitigen Port, der in den tatsächlichen App-Einstellungen angezeigt wird.

Wenn Seerr nicht geöffnet wird, überprüfen Sie den Container, bevor Sie Jellyfin untersuchen:

docker ps
docker images
docker logs SEERR_CONTAINER_NAME --tail 100

Diese Befehle waren die ersten Prüfungen zur Fehlerbehebung, die im Community-Thread vorgeschlagen wurden. Wenn Docker-Befehle auf Ihrem ZimaOS-Build erweiterte Host-Berechtigungen erfordern, verwenden Sie den autorisierten Terminal-Workflow, anstatt die Berechtigungen für den Docker-Socket zu lockern.

Schritt 2: Seerr mit Jellyfin verbinden

Richten Sie Jellyfin während der Seerr-Einrichtung mit einem administrativen Jellyfin-Konto ein. Laut der aktuellen Seerr-Dokumentation ist die Jellyfin-Einstellungsseite für die Serververbindung und die Bibliothekssynchronisierung zuständig.

Bestätigen Sie vor dem Fortfahren Folgendes:

  • Seerr kann die von Ihnen eingegebene Jellyfin-URL erreichen.
  • Das für die Einrichtung verwendete Jellyfin-Konto verfügt über die erforderlichen Administratorrechte.
  • Ihre Jellyfin-Bibliotheken werden nach der Synchronisierung in Seerr angezeigt.
  • Ein manueller Bibliotheksscan wird erfolgreich abgeschlossen.

Lesen Sie den Leitfaden zu den Seerr-Medienserver-Einstellungen, um den aktuellen Ablauf für die Verbindung mit Jellyfin zu erfahren.

Schritt 3: Seerr mit Sonarr und Radarr verbinden

Seerr lädt Medien nicht selbst herunter. Es sendet genehmigte Anfragen an Sonarr und Radarr, die anschließend den Rest des Automatisierungsstapels koordinieren.

Sonarr und Radarr können ausgeführt werden:

  • auf demselben ZimaOS-Host;
  • in separaten Docker-Containern;
  • auf einem anderen Heimserver;
  • oder, wie ein Community-Nutzer beschrieben hat, auf einem separaten Raspberry Pi.

Entscheidend ist die Erreichbarkeit. Seerr muss eine Adresse verwenden, die aus dem Seerr-Container oder dem Host-Kontext funktioniert. Eine Browser-URL, die auf Ihrem Laptop funktioniert, ist nicht automatisch die richtige Adresse für die Kommunikation zwischen Containern.

Gehen Sie nicht davon aus, dass Container aus dem ZimaOS App Store dasselbe Docker-Netzwerk verwenden.

Die nützlichste Warnung zum Netzwerk in der Community-Antwort war, dass ein über den ZimaOS App Store installierter Jellyfin-Container einen manuell installierten Seerr-Container möglicherweise nicht automatisch über dessen Containernamen erreicht.

Wenn sich beide Container im selben benutzerdefinierten Docker-Netzwerk befinden, kann ein Dienstname wie etwa:

http://seerr:5055

kann funktionieren. Wenn sie sich in unterschiedlichen Docker-Netzwerken befinden, verwende stattdessen eine erreichbare Hostadresse und einen veröffentlichten Port, zum Beispiel:

http://ZIMAOS_LAN_IP:5055

Verwende nicht localhost gelegentlich zwischen Containern. Im Jellyfin-Container localhost bezieht sich auf den Jellyfin-Container selbst, nicht auf einen separaten Seerr-Container.

Schritt 4: JellyBridge in Jellyfin installieren

JellyBridge ist ein Jellyfin-Plugin und keine weitere ZimaOS-App, die Jellyfin ersetzen soll. Die aktuelle Installationsmethode des Projekts empfiehlt, das Plugin-Repository über die Administrationsoberfläche von Jellyfin hinzuzufügen.

In Jellyfin:

  1. Öffne Dashboard > Plugins.
  2. Öffne die Repository-Verwaltung.
  3. Füge die vom Projekt bereitgestellte URL des JellyBridge-Plugin-Repositorys hinzu.
  4. Öffne den Plugin-Katalog.
  5. Installiere den JellyBridge-Build, der zu deiner Jellyfin-Version passt.
  6. Starte Jellyfin neu.

Das aktuelle JellyBridge-Repository dokumentiert versionsspezifische Plugin-Builds für Jellyfin 10.10 und 10.11. Prüfe vor der Auswahl eines Pakets die Kompatibilitätshinweise. Siehe die Projektdokumentation von JellyBridge.

Schritt 5: JellyBridge für den Zugriff auf Seerr konfigurieren

Öffne nach dem Neustart von Jellyfin die Konfiguration des JellyBridge-Plugins und gib Folgendes an:

  • die von Jellyfin erreichbare Seerr-URL;
  • den vom Plugin benötigten Seerr-API-Schlüssel;
  • ein eigenes Verzeichnis für die JellyBridge-Bibliotheksdaten;
  • das gewünschte Synchronisierungsverhalten.

Verwende vor dem Importieren von Entdeckungsinhalten die Funktion Verbindung testen des Plugins. Wenn der Test fehlschlägt, erstelle noch keine weiteren Bibliotheken. Korrigiere zuerst die Seerr-URL, das Docker-Netzwerk oder den API-Schlüssel.

Schritt 6: JellyBridge-Entdeckungsbibliothek erstellen

JellyBridge erstellt Platzhalter- und Entdeckungsinhalte, die Jellyfin als Bibliothek anzeigen kann. Die aktuelle Plugin-Dokumentation enthält einen Einrichtungsablauf direkt im Plugin zum Erstellen und Konfigurieren dieser Bibliothek.

Halte diese Bibliothek getrennt von deinen tatsächlichen Pfaden für Film- und TV-Medien. JellyBridge-Entdeckungsinhalte sind kein Ersatz für die echten Dateien, die von Sonarr, Radarr und Jellyfin verwaltet werden.

Wenn Benutzer unterstützte Entdeckungsinhalte in Jellyfin zu ihren Favoriten hinzufügen, kann JellyBridge die entsprechende Anfrage an Seerr senden. Seerr übernimmt dann die Genehmigung und leitet die Anfrage entsprechend deiner Konfiguration an Sonarr oder Radarr weiter.

Das Community-ZimaBoard-2-Beispiel

Ein späterer Teilnehmer berichtete, dass Jellyfin und die neuere Seerr-Anwendung gemeinsam auf einem ZimaBoard 2 liefen, während der ARR-Stack auf einem Raspberry Pi 4 ausgeführt wurde. Das ist ein nützlicher Beleg dafür, dass sich die Architektur über mehrere Systeme erstrecken kann.

Der aktuelle Produktpfad für ZimaBoard-Hardware ist der ZimaBoard 2 Single-Board-Server.

Die Antwort enthielt nicht die genauen Docker-Compose-Dateien oder Netzwerkeinstellungen des Nutzers und sollte daher nicht als verifizierte Konfiguration zum Kopieren und Einfügen betrachtet werden. Ihr Wert liegt in der Architektur: Die Dienste können getrennt werden, solange jeder Integrationsendpunkt erreichbar ist.

Fehlerbehebung für den Stack in dieser Reihenfolge

  1. Bestätige, dass Jellyfin unabhängig funktioniert.
  2. Bestätige, dass der Seerr-Container weiter ausgeführt wird.
  3. Öffne die Seerr-Weboberfläche direkt.
  4. Bestätige, dass sich Seerr bei Jellyfin authentifizieren und Bibliotheken synchronisieren kann.
  5. Bestätige, dass Seerr eine Verbindung zu Sonarr und Radarr herstellen kann.
  6. Installiere die mit deiner Jellyfin-Version kompatible JellyBridge-Version.
  7. Bestätige, dass JellyBridge seine Verbindung zu Seerr testen kann.
  8. Erstelle die JellyBridge-Erkennungsbibliothek erst, nachdem der Verbindungstest erfolgreich war.
  9. Sende eine Anfrage aus Jellyfin und bestätige, dass sie in Seerr erscheint.
  10. Überprüfe anschließend, ob Seerr die Anfrage an die richtige Sonarr- oder Radarr-Instanz weiterleitet.

Jellyfin-, Seerr- und JellyBridge-FAQ

Benötigt Seerr einen eigenen Docker-Container?

Ja. Seerr ist eine eigenständige Anwendung zur Verwaltung von Anfragen. JellyBridge ist das Jellyfin-Plugin, das mit Seerr kommuniziert.

Sollte JellyBridge als ZimaOS-App-Store-Anwendung erscheinen?

Nicht unbedingt. Das aktuelle JellyBridge-Projekt wird als Jellyfin-Plugin verteilt, das über das Plugin-Repository-System von Jellyfin installiert wird.

Warum schlägt localhost:5055 von JellyBridge aus fehl?

Wenn Jellyfin und Seerr separate Container sind, localhost in Jellyfin verweist zurück auf den Jellyfin-Container. Verwende einen gemeinsamen Docker-Netzwerkdienstnamen oder eine Host-/IP-Adresse, die der Jellyfin-Container tatsächlich erreichen kann.

Soll ich Jellyseerr oder Seerr installieren?

Für eine neue, aktuelle Bereitstellung ist Seerr der unterstützte Nachfolger. Die JellyBridge-Dokumentation enthält weiterhin Jellyseerr-Bezeichnungen und Hinweise zur Kompatibilität, da der Übergang erst kürzlich erfolgt ist. Überprüfe daher deine JellyBridge-Version anhand der installierten Seerr-Version.

Können Sonarr und Radarr auf einem anderen Server laufen?

Ja. Ein Community-Nutzer beschrieb genau diese Anordnung. Seerr benötigt lediglich Netzwerkzugriff auf die Sonarr-/Radarr-API-Endpunkte und gültige API-Schlüssel; die Anwendungen müssen nicht auf demselben physischen Server laufen.