Communityoplossing

Een Synology- of SMB-share koppelen voor Plex op ZimaOS

A 2025 ZimaOS troubleshooting thread on making Plex see media stored on another NAS. IceWhale clarified that LAN shares are mounted under /media, while a later community solution also matched Plex PUID/PGID and browsed the mounted share into the container.

Plex kan media gebruiken die op een andere NAS zijn opgeslagen, maar een LAN-share die zichtbaar is in de Bestanden-app van ZimaOS is niet automatisch zichtbaar in de Plex-container. Deze thread uit 2025 begon met een Synology-share die via een handmatige koppeling in CasaOS werkte, maar op ZimaOS verwarrend werd omdat het basissysteem alleen-lezen is en de Bestanden-interface een pad toonde dat niet rechtstreeks naar Plex kon worden vertaald.

In de thread werden uiteindelijk twee afzonderlijke stappen vastgesteld: koppel eerst de externe SMB-share aan ZimaOS en koppel daarna het resulterende hostpad aan de Plex-container. Een latere gebruiker ontdekte ook dat het in hun omgeving nodig was om de gebruikers-ID's van de container gelijk te maken aan die van het ZimaOS-account.

Koppel de LAN-share eerst aan in ZimaOS

In het officiële antwoord van Zima-Giorgio staat dat je de externe opslag als LAN/SAMBA-share moet toevoegen in de Bestanden-app van ZimaOS. Zodra deze is aangekoppeld, wordt het werkelijke pad aan de hostzijde geplaatst onder /media, in plaats van het netwerkachtige pad dat in sommige delen van de Bestanden-interface werd weergegeven.

een ZimaOS-terminal getoond waarin LAN-SMB-shares onder de kleinelettermap /media werden weergegeven
In het voorbeeld van IceWhale werd ls /media om de werkelijke hostpaden te tonen die voor aangekoppelde LAN-shares zijn aangemaakt.

De officiële opdracht voor probleemoplossing in de thread is:

ls /media

Dit is belangrijk omdat Plex het hostpad nodig heeft dat de aangekoppelde map is onder /mediagebruikt, en niet simpelweg een IP-adrespad dat vanuit de Bestanden-interface was gekopieerd.

Koppel het SMB-hostpad aan de Plex-container

Zodra de externe share op de ZimaOS-host bestaat, open je de Plex-appinstellingen en voeg je deze als volume toe. In een communityconfiguratie werd een hostshare zoals /media/192.168.50.20/DrivePool naar een eenvoudiger pad zoals /DrivePool in Plex.

Plex-volumes die een ZimaOS SMB-pad onder /media koppelen aan /DrivePool in de container
De rood gemarkeerde bladerknop werd gebruikt om de echte aangekoppelde SMB-map te selecteren in plaats van een verondersteld netwerkpad in te voeren.

Het huidige ZimaOS-appmodel volgt hetzelfde host-naar-containerconcept. De huidige uitleg over hoe ZimaOS opslagmappen aan app-containers koppelt is nuttig bij het kiezen welke kant van een volumekoppeling Plex moet zien.

Als Plex een lege map ziet, controleer dan de gebruikers-ID's

Een later communitylid kon de share koppelen, maar Plex zag nog steeds een lege map. Hun werkende configuratie kwam overeen met die van Plex PUID en PGID omgevingswaarden naar de ZimaOS-gebruiker die toegang had tot de SMB-koppeling. In dat voorbeeld had de ZimaOS-gebruiker UID 999 en GID 1000.

Plex-omgevingsvariabelen waarin PUID is gewijzigd naar 999, terwijl PGID 1000 blijft
Deze wijziging van PUID/PGID was een communityoplossing voor één configuratie, geen universele waarde om te kopiëren. Gebruik de ID's die bij je eigen ZimaOS-account horen.

Kopieer dit niet 999 of 1000 blindelings. Verschillende gebruikers en installaties kunnen verschillende ID's hebben, en SMB-machtigingen hangen ook af van de manier waarop de externe server de share beschikbaar stelt.

Navigeer vanuit Plex naar het containerpad

Nadat de hostshare is gekoppeld, moet Plex het pad aan de containerzijde gebruiken bij het toevoegen van een bibliotheek. In het opgeloste communityvoorbeeld navigeerde de gebruiker in de mapkiezer van Plex naar /DrivePool en selecteerde daar de mediamap.

Plex-dialoogvenster voor het toevoegen van een map, waarin door het containerpad /DrivePool werd genavigeerd om een map met tv-series te selecteren
Toen het volume zichtbaar was in de container, kon Plex door het gekoppelde /DrivePool pad zoals gewoonlijk.

Wat de thread niet garandeert

De uiteindelijke PUID/PGID-werkwijze werd door een communitylid geplaatst en door een andere gebruiker bevestigd als oplossing voor diens probleem. De officiële bijdrage van IceWhale bestond uit de padinstructies aan de ZimaOS-zijde onder /media. Uit de thread blijkt niet dat elke Synology, SMB-server, elk model voor bestandssysteemrechten of elke latere ZimaOS-release zich identiek gedraagt.

Veelgestelde vragen over Plex SMB-shares

Waarom kan Bestanden in ZimaOS mijn NAS wel zien, maar Plex niet?

Bestanden ziet de op de host gekoppelde share. Plex draait in een container en heeft dat hostpad expliciet aan zijn eigen bestandssysteem gekoppeld nodig.

Waar koppelt ZimaOS LAN-shares?

In het antwoord van IceWhale uit 2025 staat dat gekoppelde LAN-shares te vinden zijn onder de kleine letters /media map.

Welk pad moet ik aan de Plex-bibliotheek toevoegen?

Gebruik het pad aan de containerzijde dat door de volumekoppeling van Plex is aangemaakt, niet het oorspronkelijke SMB-adres dat in de app Bestanden wordt weergegeven.

Moet ik PUID en PGID altijd wijzigen?

Nee. Dat was de extra stap die nodig was in één opgeloste communitycase. Wijzig ze alleen wanneer je containergebruiker geen toestemming heeft om de gekoppelde share te lezen.