Het ZimaOS-formulier ‘Een aangepaste app installeren’ is veel eenvoudiger te gebruiken zodra je beseft dat het gewone Docker Compose-concepten naar velden vertaalt. De brondraad uit juni 2026 is een sterk voorbeeld voor beginners, omdat de gebruiker Jellyfin al werkend had, Subsyncarr wilde toevoegen voor ondertitelverwerking en bang was de bestaande mediaserver te verstoren.
Het antwoord van de community zei niet simpelweg: ‘plak het Compose-bestand.’ Er werd uitgelegd welke waarden thuishoren bij Docker-image, Tag, Netwerk, Volumes, Omgevingsvariabelen, Apparaten en Containeropdracht, en vooral waarom omgevingswaarden zoals SCAN_PATHS paden moeten gebruiken die binnen de container zichtbaar zijn.
Lees het ZimaOS-formulier als Docker-configuratie
Voor het bronvoorbeeld heeft de community de basisvelden van Compose ongeveer als volgt toegewezen:
- Docker-image →
mrorbitman/subsyncarr - Tag → de gewenste releasetag, historisch gezien
latest - Titel → een gebruiksvriendelijke appnaam, zoals
Subsyncarr - Netwerk →
bridgetenzij de huidige instructies van de app iets anders vereisen
Gebruik het upstream Compose-voorbeeld als bron van waarheid
Subsyncarr is zich blijven ontwikkelen. Vergelijk daarom vóór de installatie een oude community-schermafbeelding met de huidige containerinstellingen van Subsyncarr.
Volumes zijn het belangrijkste onderdeel
Een Docker-volume heeft twee kanten:
- Hostpad: de echte ZimaOS-map met films, tv, anime of applicatiegegevens.
- Containerpad: het pad dat Subsyncarr binnen zijn eigen bestandssysteem ziet.
Een toewijzing kan er conceptueel als volgt uitzien:
Host: /DATA/Media/Movies
Container: /moviesDe exacte hostmap hangt af van de locatie van je Jellyfin-bibliotheek. Kopieer niet zomaar het pad van een andere gebruiker. Controleer de Bestanden-app van ZimaOS of bekijk de bestaande volumetoewijzingen van Jellyfin, zodat beide containers naar dezelfde media verwijzen.
De huidige uitleg van hoe echte ZimaOS-opslagmappen containerpaden worden is nuttig voordat je een aangepaste mediaapplicatie toevoegt.
SCAN_PATHS moet overeenkomen met de containerzijde
Dit was het belangrijkste leerpunt in het oorspronkelijke antwoord. Als de hostmap is gekoppeld aan /movies in de container; vervolgens moet Subsyncarr scannen /movies.
Correct:
SCAN_PATHS=/movies,/tv,/animeOnjuist wanneer dit alleen hostpaden zijn:
SCAN_PATHS=/DATA/Media/MoviesDe container kan geen willekeurige ZimaOS-hostpaden zien, tenzij die mappen expliciet aan de container zijn gekoppeld.
Vertaal omgevingsvariabelen één voor één
Het oorspronkelijke Compose-voorbeeld bevatte variabelen zoals tijdzone, cron-schema, scanpaden, uitgesloten mappen en synchronisatie-engines. Voeg ze allemaal toe aan het gedeelte Omgevingsvariabelen, met dezelfde waardesemantiek als de upstreamapplicatie verwacht.
Probeer een cron-expressie niet te ‘verbeteren’ en hernoem een containerpad niet tijdens het vertalen. Reproduceer eerst de upstreamconfiguratie getrouw en breng pas wijzigingen aan nadat bekend is dat de app werkt.
Huidige Subsyncarr-versies hebben een Web UI
In het antwoord van de community uit 2026 werd geadviseerd om Web UI en Poorten leeg te laten, tenzij uit de documentatie bleek dat de applicatie er een beschikbaar stelde. Dat advies was correct voor een onbekende applicatie, maar huidige Subsyncarr-versies bieden nu een Web UI op poort 3000 en permanente applicatiegegevens.
Als je het dashboard wilt gebruiken, publiceer je een hostpoort naar containerpoort 3000 en stel je het veld Web UI van ZimaOS in op dat hostadres. Als de poort al in gebruik is, wijzig je alleen de hostzijde, tenzij de upstream-ontwikkelaar aangeeft dat de interne servicepoort zelf configureerbaar is.
De eigen applicatiegegevens van Subsyncarr persistent maken
Mediamappen zijn niet de enige belangrijke volumes. De huidige versie van Subsyncarr heeft ook eigen persistente gegevens. Bewaar die applicatiestatus in een hostmap die containerupdates overleeft en neem deze op in back-ups.
PUID en PGID zijn belangrijk wanneer ondertitels moeten worden geschreven
Een ondertitelverwerker heeft meer nodig dan alleen leestoegang. Mogelijk moet deze ondertitelbestanden naast de media aanmaken, hernoemen of wijzigen. De huidige versie van Subsyncarr ondersteunt PUID en PGID. Stem de containergebruiker daarom af op de eigenaar- of groepsmachtigingen van de mediamappen als scans wel werken maar het schrijven van ondertitels mislukt.
Laat Devices en Container Command leeg, tenzij de upstream-ontwikkelaar dit vereist
Het antwoord uit de community adviseerde terecht om niet elk veld in te vullen alleen omdat het bestaat. Een apparaatkoppeling is bedoeld voor hardware zoals GPU's of seriële apparaten. Container Command overschrijft de standaardopdracht voor het opstarten van de image. Geen van beide moet worden toegevoegd zonder een specifieke vereiste van de upstream-ontwikkelaar.
Waarom dit Jellyfin niet zou moeten verstoren
Het toevoegen van een afzonderlijke container wijzigt Jellyfin niet alleen omdat beide applicaties dezelfde mediamap lezen. Het grotere risico zit bij de machtigingen: als Subsyncarr bestanden mag hernoemen of schrijven, controleer dan of de configuratie alleen de media- en ondertitelpaden aanpast die je bedoelt.
Begin met een kleine testbibliotheek voordat je de applicatie toegang geeft tot de volledige collectie.
Veelgestelde vragen over aangepaste ZimaOS-apps
Gebruikt SCAN_PATHS het hostpad of het containerpad?
Gebruik de containerpaden die door je volumekoppelingen zijn aangemaakt.
Moet ik elk veld in het formulier voor aangepaste apps van ZimaOS invullen?
Nee. Configureer alleen poorten, apparaten, opdrachten en andere velden die de applicatie daadwerkelijk nodig heeft.
Heeft de huidige versie van Subsyncarr een webinterface?
Ja. Huidige releases bieden een dashboard op poort 3000.
Kan Subsyncarr dezelfde mediamappen gebruiken als Jellyfin?
Ja, zolang beide containers dezelfde echte hostmappen koppelen en de machtigingen juist zijn.
