Jellyfin, Seerr e JellyBridge non sono tre componenti di un’unica app di ZimaOS. Il thread della community IceWhale di giugno 2026 è diventato più facile da comprendere una volta separato lo stack in livelli: Jellyfin è il server multimediale, Seerr è un’applicazione autonoma per le richieste di contenuti multimediali e JellyBridge è un plugin di Jellyfin che collega le funzioni di scoperta e richiesta di Jellyfin a Seerr.
L’autore del post originale aveva già Jellyfin in esecuzione dall’App Store di ZimaOS, ma non riusciva a far funzionare il resto dello stack. Le risposte della community consigliavano di diagnosticare ogni livello separatamente, invece di cambiare tutto in una volta. In seguito, un altro utente ha confermato di avere Jellyfin e Seerr in esecuzione correttamente su uno ZimaBoard 2, mentre il suo stack Sonarr/Radarr funzionava su un Raspberry Pi separato, dimostrando che questi servizi non devono risiedere nello stesso container e nemmeno sulla stessa macchina, purché URL, credenziali API e percorsi di rete siano corretti.
Comprendi prima lo stack Jellyfin → Seerr → JellyBridge
Il modo più semplice per considerare questa configurazione è:
- Jellyfin: distribuisce e gestisce le librerie esistenti di film e programmi TV.
- Seerr: fornisce funzioni di scoperta e richieste di contenuti multimediali, quindi invia le richieste approvate a Sonarr e Radarr.
- Sonarr/Radarr: gestiscono i flussi di acquisizione di serie TV e film.
- JellyBridge: viene eseguito all’interno di Jellyfin come plugin e comunica con Seerr, così le azioni di scoperta o aggiunta ai preferiti in Jellyfin possono creare richieste.
La documentazione attuale di Seerr descrive Seerr come un gestore delle richieste e della scoperta di contenuti multimediali per Jellyfin, Plex ed Emby, con integrazione nativa con Sonarr e Radarr. Seerr viene normalmente eseguito come container Docker autonomo ed espone la propria interfaccia web sulla porta 5055. Consulta la guida attuale di Seerr per iniziare.
Seerr è l’attuale successore di Jellyseerr e Overseerr
Una risposta della community ha fatto notare che Seerr aveva sostituito la precedente applicazione Jellyseerr. La documentazione attuale del progetto Seerr conferma che Seerr è il successore unificato per gli utenti di Jellyseerr e Overseerr.
Questo è importante perché la documentazione, gli screenshot, le variabili d’ambiente o i nomi dei container meno recenti di JellyBridge potrebbero ancora riportare Jellyseerr. L’attuale progetto JellyBridge afferma che Seerr 3.x utilizza un’API compatibile per l’integrazione testata, pur mantenendo la terminologia Jellyseerr in alcune parti della documentazione.
Se stai creando ora questo stack, inizia con la versione attuale di Seerr invece di installare intenzionalmente una versione obsoleta di Jellyseerr, a meno che una versione specifica del plugin non la richieda esplicitamente.
Passaggio 1: fai funzionare Seerr prima di installare JellyBridge
Non eseguire il troubleshooting di JellyBridge finché Seerr non è operativo. Installa Seerr come applicazione Docker ZimaOS separata oppure usando la sorgente dell'app supportata dal sistema in uso.
Dopo l'installazione, verifica direttamente l'interfaccia web di Seerr:
http://ZIMAOS_LAN_IP:5055La porta dell'host può essere diversa se la mappatura del container ZimaOS utilizza un'altra porta esterna. Usa la porta lato host mostrata nelle impostazioni effettive dell'app.
Se Seerr non si apre, controlla il container prima di intervenire su Jellyfin:
docker ps
docker images
docker logs SEERR_CONTAINER_NAME --tail 100Questi comandi sono stati i primi controlli per la risoluzione dei problemi suggeriti nella discussione della community. Se i comandi Docker richiedono autorizzazioni elevate sull'host nella tua versione di ZimaOS, usa la procedura del terminale autorizzato invece di indebolire le autorizzazioni del socket Docker.
Passaggio 2: collega Seerr a Jellyfin
Durante la configurazione di Seerr, configura Jellyfin usando un account Jellyfin amministrativo. La documentazione aggiornata di Seerr indica che la pagina delle impostazioni di Jellyfin gestisce la connessione al server e la sincronizzazione delle librerie.
Conferma quanto segue prima di continuare:
- Seerr riesce a raggiungere l'URL Jellyfin inserito.
- L'account Jellyfin utilizzato durante la configurazione dispone dell'accesso amministrativo richiesto.
- Le tue librerie Jellyfin vengono visualizzate in Seerr dopo la sincronizzazione.
- Una scansione manuale della libreria viene completata correttamente.
Consulta la guida alle impostazioni del server multimediale di Seerr per la procedura aggiornata di connessione a Jellyfin.
Passaggio 3: collega Seerr a Sonarr e Radarr
Seerr non scarica direttamente i contenuti multimediali. Invia le richieste approvate a Sonarr e Radarr, che coordinano il resto dello stack di automazione.
Sonarr e Radarr possono essere eseguiti:
- sullo stesso host ZimaOS;
- in container Docker separati;
- su un altro server domestico;
- oppure, come ha descritto un utente della community, su un Raspberry Pi separato.
Il requisito importante è la raggiungibilità. Seerr deve usare un indirizzo che funzioni dal contesto del container Seerr o dell'host. Un URL del browser che funziona sul tuo laptop non è automaticamente l'indirizzo corretto per la comunicazione tra container.
Non dare per scontato che i container dell'App Store di ZimaOS condividano la stessa rete Docker
L'avvertenza di rete più utile nella risposta della community era che un container Jellyfin installato dall'App Store di ZimaOS potrebbe non rilevare automaticamente, tramite il nome del container, un container Seerr installato manualmente.
Se entrambi i container si trovano sulla stessa rete Docker definita dall'utente, puoi usare un nome di servizio come:
http://seerr:5055potrebbe funzionare. Se si trovano su reti Docker diverse, usa invece un indirizzo host raggiungibile e una porta pubblicata, ad esempio:
http://ZIMAOS_LAN_IP:5055Non utilizzare localhost in modo informale tra i container. All'interno del container Jellyfin, localhost si riferisce al container Jellyfin stesso, non a un container Seerr separato.
Passaggio 4: Installa JellyBridge all'interno di Jellyfin
JellyBridge è un plugin di Jellyfin, non un'altra app di ZimaOS che deve sostituire Jellyfin. L'attuale metodo di installazione del progetto consiglia di aggiungere il relativo repository dei plugin tramite l'interfaccia di amministrazione di Jellyfin.
In Jellyfin:
- Apri Dashboard > Plugin.
- Apri la gestione dei repository.
- Aggiungi l'URL del repository del plugin JellyBridge fornito dal progetto.
- Apri il catalogo dei plugin.
- Installa la build di JellyBridge compatibile con la tua versione di Jellyfin.
- Riavvia Jellyfin.
Il repository attuale di JellyBridge documenta build del plugin specifiche per Jellyfin 10.10 e 10.11. Controlla le note sulla compatibilità prima di scegliere un pacchetto. Consulta la documentazione del progetto JellyBridge.
Passaggio 5: Configura JellyBridge per raggiungere Seerr
Dopo il riavvio di Jellyfin, apri la configurazione del plugin JellyBridge e fornisci:
- l'URL di Seerr raggiungibile da Jellyfin;
- la chiave API di Seerr richiesta dal plugin;
- una directory dedicata ai dati della libreria JellyBridge;
- il comportamento di sincronizzazione che vuoi utilizzare.
Usa la funzione Test connessione del plugin prima di importare i contenuti scoperti. Se il test fallisce, non creare ancora altre librerie. Risolvi prima i problemi relativi all'URL di Seerr, alla rete Docker o alla chiave API.
Passaggio 6: Crea la libreria Discover di JellyBridge
JellyBridge crea contenuti segnaposto e di scoperta che Jellyfin può mostrare come libreria. La documentazione attuale del plugin include una procedura di configurazione interna al plugin per generare e configurare questa libreria.
Mantieni questa libreria separata dai percorsi effettivi dei contenuti multimediali di film e serie TV. Gli elementi scoperti da JellyBridge non sostituiscono i file reali gestiti da Sonarr, Radarr e Jellyfin.
Quando gli utenti aggiungono ai preferiti elementi scoperti supportati in Jellyfin, JellyBridge può inviare la richiesta corrispondente a Seerr. Seerr gestisce quindi l'approvazione e inoltra la richiesta a Sonarr o Radarr in base alla configurazione.
L'esempio Community ZimaBoard 2
Un partecipante successivo ha detto di aver fatto funzionare Jellyfin e la nuova applicazione Seerr insieme su uno ZimaBoard 2, mentre il suo stack ARR era in esecuzione su un Raspberry Pi 4. Questa è un'utile conferma del fatto che l'architettura può estendersi su più sistemi.
Il prodotto attuale per l'hardware ZimaBoard è il server single-board ZimaBoard 2.
La risposta non forniva i file Docker Compose esatti dell'utente né le impostazioni di rete, quindi non deve essere considerata una configurazione verificata da copiare e incollare. Il suo valore è architetturale: i servizi possono essere separati, purché ogni endpoint di integrazione sia raggiungibile.
Risoluzione dei problemi dello stack in questo ordine
- Verifica che Jellyfin funzioni autonomamente.
- Verifica che il container Seerr rimanga in esecuzione.
- Apri direttamente l'interfaccia web di Seerr.
- Verifica che Seerr riesca ad autenticarsi a Jellyfin e a sincronizzare le librerie.
- Verifica che Seerr riesca a connettersi a Sonarr e Radarr.
- Installa la versione di JellyBridge compatibile con la tua versione di Jellyfin.
- Verifica che JellyBridge riesca a testare la connessione a Seerr.
- Crea la libreria di rilevamento di JellyBridge solo dopo che il test di connessione è andato a buon fine.
- Invia una richiesta di prova da Jellyfin e verifica che compaia in Seerr.
- Verifica quindi che Seerr inoltri la richiesta all'istanza Sonarr o Radarr corretta.
Domande frequenti su Jellyfin, Seerr e JellyBridge
Seerr ha bisogno di un proprio container Docker?
Sì. Seerr è un'applicazione indipendente per la gestione delle richieste. JellyBridge è il plugin Jellyfin che comunica con essa.
JellyBridge dovrebbe comparire come applicazione nell'App Store di ZimaOS?
Non necessariamente. Il progetto JellyBridge attuale viene distribuito come plugin Jellyfin installato tramite il sistema del repository dei plugin di Jellyfin.
Perché localhost:5055 non funziona da JellyBridge?
Se Jellyfin e Seerr sono container separati, localhost all'interno di Jellyfin rimanda al container Jellyfin. Usa il nome di un servizio della rete Docker condivisa oppure un indirizzo host/IP effettivamente raggiungibile dal container Jellyfin.
Devo installare Jellyseerr o Seerr?
Per una nuova installazione attuale, Seerr è il percorso successivo supportato. La documentazione di JellyBridge contiene ancora la terminologia e le note sulla compatibilità di Jellyseerr perché la transizione è recente; verifica quindi che la versione di JellyBridge sia compatibile con la versione di Seerr che installi.
Sonarr e Radarr possono essere eseguiti su un altro server?
Sì. Un utente della community ha descritto esattamente questa configurazione. Seerr ha bisogno solo dell'accesso di rete agli endpoint API di Sonarr/Radarr e di chiavi API valide; le applicazioni non devono necessariamente condividere lo stesso server fisico.
