Jellyfin, Seerr e JellyBridge não são três componentes de uma única aplicação do ZimaOS. O tópico da IceWhale Community de junho de 2026 tornou-se mais fácil de compreender quando a arquitetura foi dividida em camadas: o Jellyfin é o servidor multimédia, o Seerr é uma aplicação autónoma de pedidos de conteúdos multimédia e o JellyBridge é um plugin do Jellyfin que liga a descoberta e as ações de pedido do Jellyfin ao Seerr.
O autor da publicação original já tinha o Jellyfin a funcionar a partir da App Store do ZimaOS, mas não conseguia pôr o resto da arquitetura a funcionar. As respostas da comunidade recomendaram diagnosticar cada camada de forma independente, em vez de alterar tudo ao mesmo tempo. Mais tarde, outro utilizador confirmou que tinha o Jellyfin e o Seerr a funcionar corretamente num ZimaBoard 2, enquanto a sua arquitetura Sonarr/Radarr era executada num Raspberry Pi separado, demonstrando que estes serviços não precisam de estar no mesmo contentor, nem sequer na mesma máquina, desde que os URLs, as credenciais da API e as rotas de rede estejam corretos.
Compreenda primeiro a arquitetura Jellyfin → Seerr → JellyBridge
A forma mais simples de entender esta configuração é:
- Jellyfin: disponibiliza e gere as suas bibliotecas existentes de filmes e séries de televisão.
- Seerr: disponibiliza a descoberta e os pedidos de conteúdos multimédia, enviando depois os pedidos aprovados para o Sonarr e o Radarr.
- Sonarr/Radarr: tratam dos fluxos de aquisição de séries de televisão e filmes.
- JellyBridge: é executado dentro do Jellyfin como um plugin e comunica com o Seerr, permitindo que ações de descoberta ou de adição aos favoritos no Jellyfin criem pedidos.
A documentação atual do Seerr descreve-o como um gestor de pedidos e descoberta de conteúdos multimédia para Jellyfin, Plex e Emby, com integração nativa com Sonarr e Radarr. Normalmente, o Seerr é executado no seu próprio contentor Docker e disponibiliza a sua interface Web na porta 5055. Consulte o guia atual de introdução ao Seerr.
O Seerr é o sucessor atual do Jellyseerr e do Overseerr
Uma resposta da comunidade referiu que o Seerr tinha substituído a aplicação Jellyseerr mais antiga. A documentação atual do projeto Seerr confirma que o Seerr é o sucessor conjunto para os utilizadores do Jellyseerr e do Overseerr.
Isto é importante porque a documentação, as capturas de ecrã, as variáveis de ambiente ou os nomes dos contentores mais antigos do JellyBridge podem ainda indicar Jellyseerr. O projeto atual do JellyBridge afirma que o Seerr 3.x utiliza uma API compatível para a integração que testou, embora mantenha a terminologia Jellyseerr em algumas partes da documentação.
Se estiver a criar esta pilha agora, comece pelo Seerr atual em vez de instalar intencionalmente uma versão obsoleta do Jellyseerr, exceto se uma versão específica do plug-in exigir explicitamente essa versão.
Passo 1: Colocar o Seerr a funcionar antes de instalar o JellyBridge
Não resolva problemas do JellyBridge até o próprio Seerr estar a funcionar corretamente. Instale o Seerr como uma aplicação Docker separada no ZimaOS ou utilizando a fonte de aplicações suportada disponível no seu sistema atual.
Após a instalação, verifique diretamente a interface Web do Seerr:
http://ZIMAOS_LAN_IP:5055A porta do anfitrião pode ser diferente se o mapeamento do contentor no ZimaOS utilizar outra porta externa. Utilize a porta do lado do anfitrião apresentada nas definições reais da aplicação.
Se o Seerr não abrir, verifique primeiro o contentor antes de mexer no Jellyfin:
docker ps
docker images
docker logs SEERR_CONTAINER_NAME --tail 100Esses comandos foram as primeiras verificações de resolução de problemas sugeridas no tópico da comunidade. Se os comandos Docker exigirem permissões elevadas no anfitrião na sua compilação do ZimaOS, utilize o fluxo de terminal autorizado em vez de reduzir a segurança das permissões do socket Docker.
Passo 2: Ligar o Seerr ao Jellyfin
Durante a configuração do Seerr, configure o Jellyfin utilizando uma conta Jellyfin com privilégios administrativos. A documentação atual do Seerr indica que a página de definições do Jellyfin é responsável pela ligação ao servidor e pela sincronização das bibliotecas.
Confirme o seguinte antes de continuar:
- O Seerr consegue aceder ao URL do Jellyfin que introduziu.
- A conta Jellyfin utilizada durante a configuração tem os privilégios administrativos necessários.
- As suas bibliotecas Jellyfin aparecem no Seerr após a sincronização.
- Uma análise manual da biblioteca é concluída com êxito.
Consulte o guia de definições do servidor multimédia do Seerr para conhecer o fluxo de ligação atual ao Jellyfin.
Passo 3: Ligar o Seerr ao Sonarr e ao Radarr
O Seerr não descarrega multimédia por si só. Envia os pedidos aprovados para o Sonarr e o Radarr, que coordenam então o resto da pilha de automatização.
O Sonarr e o Radarr podem ser executados:
- no mesmo anfitrião ZimaOS;
- em contentores Docker separados;
- noutro servidor doméstico;
- ou, como descreveu um utilizador da comunidade, num Raspberry Pi separado.
O requisito importante é a acessibilidade. O Seerr tem de utilizar um endereço que funcione a partir do contentor Seerr ou do contexto do anfitrião. Um URL que funciona no seu portátil não é automaticamente o endereço correto para a comunicação entre contentores.
Não assuma que os contentores da App Store do ZimaOS partilham a mesma rede Docker
O aviso de rede mais útil na resposta da comunidade foi que um contentor Jellyfin instalado a partir da App Store do ZimaOS pode não detetar automaticamente, pelo nome do contentor, um contentor Seerr instalado manualmente.
Se ambos os contentores estiverem na mesma rede Docker definida pelo utilizador, um nome de serviço como:
http://seerr:5055poderá funcionar. Se estiverem em redes Docker diferentes, utilize antes um endereço de anfitrião acessível e uma porta publicada, por exemplo:
http://ZIMAOS_LAN_IP:5055Não utilize localhost de forma casual entre contentores. Dentro do contentor do Jellyfin, localhost refere-se ao próprio contentor do Jellyfin, não a um contentor Seerr separado.
Passo 4: Instalar o JellyBridge dentro do Jellyfin
O JellyBridge é um plugin do Jellyfin, não é outra aplicação do ZimaOS que tenha de substituir o Jellyfin. O método de instalação atual do projeto recomenda adicionar o respetivo repositório de plugins através da interface de administração do Jellyfin.
No Jellyfin:
- Abra Painel de controlo > Plugins.
- Abra a gestão de repositórios.
- Adicione o URL do repositório do plugin JellyBridge fornecido pelo projeto.
- Abra o catálogo de plugins.
- Instale a versão do JellyBridge compatível com a sua versão do Jellyfin.
- Reinicie o Jellyfin.
O repositório atual do JellyBridge documenta versões específicas do plugin para o Jellyfin 10.10 e 10.11. Consulte as notas de compatibilidade antes de escolher um pacote. Consulte a documentação do projeto JellyBridge.
Passo 5: Configurar o JellyBridge para aceder ao Seerr
Depois de o Jellyfin reiniciar, abra a configuração do plugin JellyBridge e forneça:
- o URL do Seerr acessível a partir do Jellyfin;
- a chave da API do Seerr exigida pelo plugin;
- um diretório dedicado aos dados da biblioteca do JellyBridge;
- o comportamento de sincronização que pretende utilizar.
Utilize a função Testar ligação do plugin antes de importar conteúdos descobertos. Se o teste falhar, não crie mais bibliotecas por enquanto. Corrija primeiro o URL do Seerr, a rede Docker ou a chave da API.
Passo 6: Criar a biblioteca de descoberta do JellyBridge
O JellyBridge cria conteúdos de marcador de posição e de descoberta que o Jellyfin pode apresentar como uma biblioteca. A documentação atual do plugin inclui um fluxo de configuração dentro do plugin para gerar e configurar essa biblioteca.
Mantenha esta biblioteca separada dos caminhos reais dos seus conteúdos de filmes e séries. Os itens descobertos pelo JellyBridge não substituem os ficheiros reais geridos pelo Sonarr, Radarr e Jellyfin.
Quando os utilizadores adicionam itens suportados à lista de favoritos no Jellyfin, o JellyBridge pode enviar o pedido correspondente para o Seerr. O Seerr trata então da aprovação e reencaminha o pedido para o Sonarr ou Radarr, de acordo com a sua configuração.
O Exemplo Comunitário do ZimaBoard 2
Um participante posterior disse que tinha o Jellyfin e a aplicação Seerr mais recente a funcionar em conjunto num ZimaBoard 2, enquanto a sua stack ARR era executada num Raspberry Pi 4. Isto é uma evidência útil de que a arquitetura pode abranger vários sistemas.
O produto atual para o hardware ZimaBoard é o servidor de placa única ZimaBoard 2.
A resposta não forneceu os ficheiros Docker Compose exatos nem as definições de rede do utilizador, pelo que não deve ser tratada como uma configuração verificada, pronta a copiar e colar. O seu valor é arquitetural: os serviços podem estar separados, desde que cada endpoint de integração esteja acessível.
Resolva os problemas da stack por esta ordem
- Confirme que o Jellyfin funciona de forma independente.
- Confirme que o contentor do Seerr permanece em execução.
- Abra diretamente a interface Web do Seerr.
- Confirme que o Seerr consegue autenticar-se no Jellyfin e sincronizar as bibliotecas.
- Confirme que o Seerr consegue estabelecer ligação ao Sonarr e ao Radarr.
- Instale a versão do JellyBridge compatível com a sua versão do Jellyfin.
- Confirme que o JellyBridge consegue testar a ligação ao Seerr.
- Crie a biblioteca de descoberta do JellyBridge apenas depois de o teste de ligação ser bem-sucedido.
- Teste um pedido a partir do Jellyfin e confirme que aparece no Seerr.
- Em seguida, confirme que o Seerr encaminha o pedido para a instância correta do Sonarr ou do Radarr.
Perguntas frequentes sobre o Jellyfin, o Seerr e o JellyBridge
O Seerr precisa do seu próprio contentor Docker?
Sim. O Seerr é uma aplicação autónoma de gestão de pedidos. O JellyBridge é o plugin do Jellyfin que comunica com ele.
O JellyBridge deve aparecer como uma aplicação na App Store do ZimaOS?
Não necessariamente. O projeto atual do JellyBridge é distribuído como um plugin do Jellyfin, instalado através do sistema de repositórios de plugins do Jellyfin.
Porque é que localhost:5055 falha a partir do JellyBridge?
Se o Jellyfin e o Seerr forem contentores separados, localhost dentro do Jellyfin aponta novamente para o contentor do Jellyfin. Utilize um nome de serviço da rede Docker partilhada ou um endereço de anfitrião/IP ao qual o contentor do Jellyfin consiga efetivamente aceder.
Devo instalar o Jellyseerr ou o Seerr?
Numa nova implementação atual, o Seerr é o sucessor mantido. A documentação do JellyBridge ainda contém a terminologia e as notas de compatibilidade do Jellyseerr porque a transição é recente, por isso confirme a compatibilidade da sua versão do JellyBridge com a versão do Seerr que instalar.
O Sonarr e o Radarr podem ser executados noutro servidor?
Sim. Um utilizador da comunidade descreveu exatamente essa configuração. O Seerr só precisa de acesso de rede aos endpoints da API do Sonarr/Radarr e de chaves de API válidas; as aplicações não precisam de partilhar o mesmo servidor físico.
