Handmatige Compose-bewerking omzeilde door ZimaOS beheerde variabelen
Een nieuwe ZimaOS-gebruiker bewerkte het Compose-bestand van Jellyfin handmatig om opslagpaden te wijzigen. Na het opnieuw opstarten waarschuwde Compose dat PGID, PUID, TZ en AppID niet waren ingesteld, en verschillende toewijzingen van hardwareapparaten werkten niet zoals verwacht.
In het antwoord van de community werd uitgelegd dat ZimaOS deze waarden normaal gesproken injecteert via de applicatiebeheerlaag. Als het gegenereerde YAML-bestand buiten die workflow wordt bewerkt, kunnen placeholders achterblijven zonder de omgeving die ZimaOS naar verwachting zou aanleveren.
Wijzig opslag via app-instellingen en volumes
De aanbevolen aanpak was om de Jellyfin-appinstellingen te openen en daar de volumetoewijzingen aan te passen, in plaats van het Compose-bestand volledig te herschrijven. ZimaOS kan dan de metadata van de applicatie, omgevingsvariabelen en apparaattoewijzingen behouden en tegelijkertijd de gekozen opslagpaden op de host toepassen.
De auteur bevestigde later dat deze methode werkte. Nadat de juiste paden op de secundaire schijf in de appinstellingen waren geselecteerd, draaide Jellyfin correct zonder de handmatige Compose-workflow.
Opnieuw installeren herstelt de door de Store geleverde configuratie
Als de gegenereerde configuratie al ingrijpend is gewijzigd, stelde het antwoord voor om Jellyfin uit het dashboard te verwijderen en opnieuw te installeren vanuit de App Store om de oorspronkelijke standaardinstellingen te herstellen. Bestaande applicatiegegevens moeten vóór het verwijderen worden behouden via correcte volumetoewijzingen op de host; het opnieuw installeren van een container is geen vervanging voor het maken van een back-up van de configuratie.
Handmatig herstellen blijft mogelijk, maar alleen als elke ontbrekende variabele en elk vereist apparaatpad correct wordt gedefinieerd. In de thread kreeg de instellingeninterface van ZimaOS de voorkeur, omdat daarmee de kans kleiner werd dat beheerde waarden verloren gingen.
Schijfkoppeling in Proxmox was een afzonderlijke complicatie
De auteur draaide ZimaOS als virtuele machine onder Proxmox op Debian 13. Een schijf die met een qm set-opdracht was doorgegeven en een verouderde /etc/fstab-koppeling veroorzaakten na het opnieuw opstarten problemen met de onderhoudsmodus. ZimaOS gaf het apparaat ook een andere naam dan de gebruiker had verwacht.
Dat virtualisatieprobleem stond los van de ontbrekende Compose-variabelen. Het werkende resultaat vereiste zowel een stabiele schijfkoppeling voor de virtuele machine als correcte Jellyfin-volumepaden in de ZimaOS-appinterface.
De latere NTP-vraag maakte geen deel uit van de Jellyfin-oplossing
De thread ging verder met tijdsynchronisatie nadat Jellyfin werkte. Het NTP-gedrag op de Proxmox-host en de gastmachine veroorzaakte de Compose-waarschuwingen niet en moet daarom afzonderlijk worden onderzocht.
Veelgestelde vragen
Waarom werden PUID, PGID, TZ en AppID leeg?
De waarschuwingen verschenen nadat handmatige bewerkingen de waarden omzeilden die normaal door de ZimaOS-applicatielaag worden beheerd.
Waar moeten de opslagpaden van Jellyfin worden gewijzigd?
De bevestigde oplossing was om de ZimaOS-appinstellingen en volumebeheerfuncties van Jellyfin te gebruiken.
Waren nieuwe stuurprogramma's nodig voor de ontbrekende hardwareapparaten?
De thread stelde geen probleem met stuurprogramma's vast. Het herstellen van de beheerde appconfiguratie en volumepaden loste de Jellyfin-configuratie van de auteur op.
