Zo controleer je of Jellyfin het verwachte configuratiebestand gebruikt

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Ja, je kunt controleren of Jellyfin de configuratiemap gebruikt die je verwacht, zonder af te gaan op de locatie waar toevallig een bestand op de host staat. De betrouwbare methode is om de prioriteitsvolgorde van Jellyfins paden te bepalen, de actieve proces- of containerinstellingen te controleren en vervolgens in de opstartlogboeken te bevestigen welk pad actief is voordat je een configuratiebestand wijzigt.

Dit is belangrijk na een overstap van een pakketinstallatie naar Docker, het klonen van een compose-bestand of het herstellen van een oudere server. Er kunnen dan meerdere kopieën van network.xml, system.xml of logging.json bestaan, terwijl slechts één map actief is. Bewerk niet elke kopie totdat het probleem verdwijnt. Bepaal eerst welke configuratiemap actief is, voer één wijziging uit die je kunt terugdraaien en controleer na een herstart of Jellyfin hetzelfde pad meldt.

Bepaal eerst de prioriteitsvolgorde van configuratiepaden

Begin met de manier waarop Jellyfin is gestart. Een opdrachtregeloptie --configdir heeft voorrang op de omgevingsvariabele JELLYFIN_CONFIG_DIR, terwijl platformstandaarden alleen worden gebruikt als instellingen met hogere prioriteit ontbreken.

De officiële prioriteitsvolgorde van configuratiepaden beschrijft de prioriteitsvolgorde voor de gegevens-, configuratie-, cache- en webmappen. Vergelijk die volgorde met je service-unit, containeromgeving of opstartopdracht voordat je ervan uitgaat dat een bekende map op de host actief is.

Als een instelling met hogere prioriteit naar een onverwachte locatie verwijst, stop dan: het concurrerende bestand dat je op schijf hebt gevonden, bewijst niet dat Jellyfin het inleest. Corrigeer de opstartconfiguratie of behoud bewust het actieve pad en documenteer dit.

Controleer de actieve container- of servicedefinitie

Controleer bij Docker de actieve container en niet alleen het compose-bestand dat op schijf staat. Het actieve object laat zien welke omgevingsvariabelen en koppelingen daadwerkelijk zijn toegepast toen die container werd aangemaakt.

De live containerdefinitie van Docker geeft informatie op laag niveau over een actieve container. Die is handig om omgevingswaarden en koppelpuntbestemmingen te vergelijken met de Jellyfin-paden die je verwacht. Een compose-bestand dat is bewerkt nadat de container is aangemaakt, komt mogelijk niet overeen met de huidige runtime.

Controleer bij een native service de systemd-unit en eventuele omgevingsbestanden die deze inleest. Als de runtimeconfiguratie en je aantekeningen niet overeenkomen, vertrouw dan op de runtime en bepaal vervolgens of je de service opnieuw wilt aanmaken met het beoogde pad.

Bevestig het pad in de opstartgegevens van Jellyfin

Start de server één keer opnieuw nadat je het verwachte pad hebt genoteerd en lees vervolgens de eerste opstartregels van Jellyfin. Zoek naar de geconfigureerde gegevens-, cache- of opslagpaden en vergelijk deze met de proces- of containerdefinitie die je zojuist hebt gecontroleerd.

Gebruik een geslaagde webaanmelding niet als bewijs dat de juiste configuratiemap actief is. Jellyfin kan normaal opstarten met een nieuw of ouder configuratiepad en toch een werkende interface tonen, terwijl gebruikersinstellingen, netwerkconfiguratie, plug-ins of geplande taken uit de verkeerde status komen.

Bij het verplaatsen van een mediaserver tussen implementatiemethoden gelden dezelfde padregels voor de bredere stack. Een praktisch beginpunt is de Jellyfin-installatie voor thuisgebruik, waarin het apppad, mediapad en toegangspad als afzonderlijke onderdelen van de installatie worden behandeld.

Gebruik één onschadelijke configuratiewijziging om uitsluitsel te krijgen

Als twee kandidaatmappen nog steeds plausibel lijken, stop Jellyfin dan voordat je een XML-configuratiebestand van de server bewerkt. Kies één omkeerbare instelling met een duidelijk effect en wijzig deze alleen in de vermoedelijk actieve map. Vermijd gebruikersgegevens, bibliotheekpaden en alles wat een grote nieuwe scan kan starten, alleen maar om te controleren welk bestand wordt gebruikt.

Start Jellyfin en controleer of de gekozen instelling zichtbaar is. Zo ja, stop de service dan opnieuw, draai de wijziging terug en start nogmaals om de persistentie te bevestigen. Zo niet, dan is het bestand niet actief of wordt het overschreven door een configuratiebron met hogere prioriteit.

Deze gecontroleerde offline A/B-test is betrouwbaarder dan tijdstempels vergelijken, omdat back-uptools, pakketupgrades en editors ook inactieve bestanden kunnen wijzigen. Jellyfin beschrijft deze configuratieopties als doorgaans statisch en bedoeld om vóór het opstarten van de server in te stellen. Voorkom daarom wijzigingen terwijl de server actief is, tenzij bij een specifieke instelling expliciet ander gedrag wordt beschreven.

Stop zodra het actieve pad een herstart doorstaat

De conclusie is bevestigd wanneer de runtime-definitie, het opstartbewijs en één omkeerbare configuratiewijziging na een herstart allemaal naar dezelfde map verwijzen. Noteer dat pad in je implementatienotities en neem het op in je back-upbereik.

Als het actieve pad na het opnieuw aanmaken van de container verandert, controleer dan hoe het volume en de omgevingsvariabelen worden gegenereerd in plaats van Jellyfin-bestanden steeds opnieuw te bewerken. Het probleem zit dan in de implementatiestatus, niet in de configuratieparser van Jellyfin.

Schaal alleen op als het runtimepad ondubbelzinnig is, maar Jellyfin een geldige instelling in het actieve bestand consequent negeert. Bewaar het opstartlogboek en de exacte versie voordat je ondersteuning inschakelt, zodat het probleem kan worden onderscheiden van een probleem met dubbele bestanden.

Ondersteuning en tips

Meer om te lezen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.