Communityoplossing

Jellyfin niet gevonden op je lokale netwerk in ZimaOS

A ZimaOS user could launch Jellyfin from the dashboard but not discover it from a phone or TV. Community replies identified the ZimaOS App Store host-port mapping and the protocol used for Jellyfin LAN discovery as the key checks.

Als Jellyfin vanuit het ZimaOS-dashboard wordt geopend, maar je telefoon of tv de server niet op het lokale netwerk kan vinden, kan de Jellyfin-container gezond zijn terwijl de LAN-poort of het detectieprotocol afwijkt van wat de Jellyfin-client verwacht. Dat onderscheid loste de verwarring op in deze discussie uit april 2026 op de IceWhale Community.

Het belangrijkste detail uit de thread is dat de daar beschreven installatie vanuit de ZimaOS App Store Jellyfin niet beschikbaar stelde op hostpoort 8096. De installatie koppelde 8097 op de ZimaOS-host aan 8096 binnen de Jellyfin-container. Een tweede probleem had betrekking op automatische detectie: Jellyfin verwacht poort 7359/UDP, terwijl de community meldde dat in de ZimaOS-appdefinitie van dat moment poort 7359 als TCP stond ingesteld. Dit zijn afzonderlijke problemen, dus test directe toegang eerst en detectie daarna.

Waarom Jellyfin wel werkt vanuit het ZimaOS-dashboard, maar niet vanaf het LAN

De oorspronkelijke poster kon Jellyfin via het ZimaOS-dashboard openen, maar een nmap nmap vond TCP-poort 8096 niet en Jellyfin-clients op een telefoon en tv konden de server niet zien. Die combinatie kan lijken op een probleem met de internetprovider of router, maar voor lokale toegang is normaal gesproken geen openbare port forwarding nodig. De eerste plek om te controleren is de Docker-poortkoppeling die door de geïnstalleerde ZimaOS-app wordt gebruikt.

Een communityreactie stelde aanvankelijk voor om te controleren op een directe koppeling zoals:

8096:8096

Een andere deelnemer gaf vervolgens het ZimaOS-specifieke detail dat van belang was voor het in de thread gebruikte App Store-pakket:

Host:      8097/TCP
Container: 8096/TCP

Met die koppeling test het scannen of openen van hostpoort 8096 de Jellyfin-webinterface niet. De juiste LAN-test voor deze installatie is:

http://ZIMAOS_LAN_IP:8097

Dit verklaart ook waarom het openen van Jellyfin vanuit het ZimaOS-dashboard wel kon werken: het dashboard kent de voor de app geconfigureerde hostpoort van de webinterface al.

Jellyfin handmatig testen voordat je problemen met detectie oplost

Voer op een telefoon, laptop of ander apparaat dat met hetzelfde thuisnetwerk is verbonden het LAN-adres van de ZimaOS-server en de daadwerkelijke host-poort in die in de Jellyfin-appinstellingen wordt weergegeven. Voor de in de thread beschreven App Store-configuratie betekent dat:

http://192.168.x.x:8097

Vervangen 192.168.x.x met het LAN-IP-adres van het ZimaOS-systeem. Als deze pagina wordt geladen, is de Jellyfin-webservice bereikbaar en ligt het resterende probleem waarschijnlijk bij automatische detectie of de clientconfiguratie, niet bij de container zelf.

Als de pagina niet wordt geladen, open je de instellingen van de Jellyfin-app in ZimaOS en controleer je de huidige toewijzing van de webinterfacepoort. Ga er niet van uit dat een huidige App Store-definitie nog exact dezelfde hostpoort gebruikt als in april 2026. App-sjablonen en netwerkinstellingen van ZimaOS kunnen per release wijzigen.

Waarom ZimaOS poort 8097 kan gebruiken terwijl de Jellyfin-documentatie 8096 vermeldt

Jellyfin gebruikt upstream 8096/TCP als standaard-HTTP-poort. De officiële Jellyfin-netwerkdocumentatie vermeldt 8096/TCP voor HTTP en 7359/UDP voor clientdetectie.

Met Docker kan een host een andere externe poort beschikbaar stellen terwijl de interne poort van Jellyfin ongewijzigd blijft. Een toewijzing zoals:

8097:8096

betekent dat apparaten op je LAN verbinding maken met ZIMAOS_IP:8097gepubliceerd, terwijl verkeer wordt doorgestuurd naar poort 8096 binnen de Jellyfin-container. Dit is geldig Docker-gedrag; de twee poortnummers hoeven niet overeen te komen.

In het officiële Jellyfin-container­voorbeeld wordt doorgaans 8096:8096/tcp en 7359:7359/udp. ZimaOS kan een andere hostzijdepoort voor de webinterface kiezen om conflicten met een andere service te voorkomen. De waarde die voor je telefoon of tv van belang is, is daarom de huidige hostpoort die in ZimaOS wordt weergegeven, en niet simpelweg de standaardwaarde van de upstreamservice.

Automatische detectie van Jellyfin gebruikt poort 7359 UDP

Het laatste antwoord in de communitythread wees op een tweede configuratiedetail: in de Docker-instellingen van ZimaOS die destijds zichtbaar waren, stond poort 7359 als TCP, terwijl Jellyfin deze poort voor lokale clientdetectie als UDP definieert.

Docker-instellingen van ZimaOS Jellyfin met de configuratie van de netwerkdetectiepoort
Het communityantwoord van april 2026 benadrukte het protocol dat voor netwerkdetectie van Jellyfin is geconfigureerd.

De huidige documentatie van Jellyfin bevestigt:

  • 8096/TCP — standaard-Jellyfin-HTTP-service binnen een standaardinstallatie.
  • 8920/TCP — optionele HTTPS-service wanneer deze is ingeschakeld.
  • 7359/UDP — Jellyfin-clientdetectie op het lokale netwerk.

Als de huidige Jellyfin-appdefinitie in ZimaOS 7359 nog steeds als TCP toewijst, wijzig die detectietoewijzing dan naar UDP of maak de toewijzing opnieuw als 7359/UDP. Wijzig de webinterfacetoewijzing niet van TCP naar UDP; HTTP op poort 8096 blijft TCP.

De Jellyfin-server handmatig toevoegen op een telefoon of tv

Automatische detectie is handig, maar niet vereist om Jellyfin te gebruiken. Als directe LAN-toegang werkt, voeg je de server handmatig toe in de Jellyfin-client met de hostpoort die door ZimaOS is geconfigureerd:

http://ZIMAOS_LAN_IP:8097

Vervang voor een andere ZimaOS-installatie 8097 met de daadwerkelijke hostpoort voor de webinterface die in de app-instellingen wordt weergegeven.

Als het handmatig ingevoerde adres werkt maar automatische detectie niet, richt je dan op poort 7359/UDP en segmentatie van het lokale netwerk in plaats van Jellyfin opnieuw te installeren. Detectiebroadcasts vereisen doorgaans dat de client en server zich in hetzelfde bereikbare lokale subnet bevinden; isolatie van gast-wifi, VLAN-regels of filtering door de firewall kan detectie verhinderen, zelfs wanneer rechtstreekse HTTP-toegang wel is toegestaan.

Zo controleer je de poorttoewijzing van Jellyfin in ZimaOS

  1. Open de instellingen van de Jellyfin-app in ZimaOS.
  2. Zoek de poorttoewijzing van de webinterface of container.
  3. Bepaal welke host-TCP-poort is toegewezen aan containerpoort 8096 van Jellyfin.
  4. Test http://ZIMAOS_LAN_IP:HOST_PORT vanaf een ander apparaat op het LAN.
  5. Controleer vervolgens de detectietoewijzing voor poort 7359.
  6. Controleer of 7359 UDP gebruikt en niet TCP, als je automatische detectie binnen het LAN wilt.
  7. Start de Jellyfin-app opnieuw nadat je de Docker-netwerkinstellingen hebt gewijzigd.

Als je een aangepaste Docker-installatie gebruikt in plaats van het ZimaOS App Store-pakket, toont de officiële handleiding voor de Jellyfin-container de referentietoewijzingen van upstream:

8096:8096/tcp
7359:7359/udp

Wat betekent het als Nmap poort 8096 niet kan zien?

In deze specifieke thread bewees een gesloten of ontbrekende hostpoort 8096 niet dat Jellyfin niet beschikbaar was. Het door de community gemelde ZimaOS App Store-pakket gebruikte in plaats daarvan hostpoort 8097. Een nuttige test is daarom om de poort te scannen die ZimaOS daadwerkelijk beschikbaar stelt:

nmap -p 8097 ZIMAOS_LAN_IP

Als je huidige app-instellingen een andere hostpoort tonen, scan dan die poort. Gebruik dit alleen als controle voor problemen binnen het LAN; je hoeft Jellyfin niet rechtstreeks aan het openbare internet bloot te stellen om een telefoon of tv in huis verbinding te laten maken.

Heb je router- of ISP-poortdoorsturing nodig voor lokale toegang tot Jellyfin?

Nee, niet voor apparaten die binnen hetzelfde thuisnetwerk communiceren. De oorspronkelijke poster nam contact op met de ondersteuning van de internetprovider, maar de in de thread beschreven symptomen hadden betrekking op lokale Docker-poorten en detectie. Poortdoorsturing vanaf het openbare internet is pas een apart onderwerp wanneer je Jellyfin bewust van buiten je thuisnetwerk wilt bereiken.

In Jellyfins eigen netwerkgids wordt gewaarschuwd dat het openstellen van een servicepoort voor een breder netwerk de blootstelling vergroot. Beperk deze probleemoplossing eerst tot LAN-toegang. Gebruik voor externe toegang een correct geconfigureerde reverse proxy, een privénetwerk-overlay of een andere veilige oplossing voor toegang op afstand, in plaats van poorten te openen zonder de beveiligingsimplicaties te begrijpen.

Checklist voor het oplossen van Jellyfin-LAN-problemen in ZimaOS

  1. Controleer of Jellyfin actief is en vanuit het ZimaOS-dashboard wordt geopend.
  2. Open de appinstellingen en noteer de huidige mapping van host naar container voor de webinterface.
  3. Als er wordt weergegeven 8097:8096, maak verbinding met http://ZIMAOS_IP:8097, niet poort 8096.
  4. Probeer dat adres vanaf een ander apparaat op hetzelfde LAN.
  5. Als directe toegang werkt, voeg je het adres handmatig toe in de mobiele Jellyfin-client of tv-client.
  6. Controleer of Jellyfin-discoverypoort 7359 als UDP is toegewezen.
  7. Controleer of de telefoon of tv niet geïsoleerd is op een gast-wifi-netwerk of door een geblokkeerde VLAN wordt afgeschermd.
  8. Start de Jellyfin-container opnieuw nadat je de poortconfiguratie hebt gewijzigd.
  9. Onderzoek pas na deze controles firewallregels op de host of complexere netwerksegmentatie.

Veelgestelde vragen over ‘Jellyfin niet gevonden’ op ZimaOS

Welke poort moet ik gebruiken voor Jellyfin op ZimaOS?

Gebruik de hostzijde van de webinterfacepoort die wordt weergegeven in de Jellyfin-appinstellingen van ZimaOS. In de communitythread van april 2026 gebruikte de installatie uit de App Store hostpoort 8097 toegewezen aan de interne poort van Jellyfin 8096. Ga er niet van uit dat elk later pakket dezelfde hostpoort gebruikt.

Waarom zegt Jellyfin dat poort 8096 wordt gebruikt, terwijl ZimaOS 8097 gebruikt?

8096 is de standaard interne HTTP-poort van Jellyfin. Docker kan die service via een andere hostpoort publiceren. De gemelde ZimaOS-mapping was 8097:8096, waardoor LAN-clients het ZimaOS-IP-adres plus poort 8097 nodig hadden.

Moet Jellyfin-poort 7359 TCP of UDP zijn?

UDP. In de officiële netwerkinformatie van Jellyfin wordt poort 7359/UDP gedefinieerd voor het detecteren van lokale clients. De community meldde een ZimaOS-appconfiguratie waarin deze als TCP werd weergegeven, wat automatische detectie kan verstoren.

Waarom kan ik Jellyfin openen vanuit het ZimaOS-dashboard, maar niet vanuit de tv-app?

Het dashboard kan de webinterface openen via de poort die intern door ZimaOS is geconfigureerd. Een tv-app moet het LAN-adres en de poort van de host kunnen bereiken, en voor automatische detectie is daarnaast UDP-discoveryverkeer nodig. Daarom bewijst toegang via het dashboard op zichzelf niet dat discovery correct is geconfigureerd.

Kan ik Jellyfin gebruiken zonder automatische serverdetectie?

Ja. Voer het serveradres handmatig in de Jellyfin-client in. Voor de mapping die in de thread werd gemeld, is het formaat http://ZIMAOS_LAN_IP:8097. Gebruik je huidige hostpoort als die afwijkt.