Communityoplossing

Syncthing slaat op in overlay2 op ZimaOS: los het mountpad op

Syncthing reported successful downloads, but files landed in Docker overlay2 because the expected FileDrop mount was absent from docker inspect.

Als Syncthing meldt dat een map is gesynchroniseerd, maar de bestanden in Docker overlay2 verschijnen, was het doelpad niet daadwerkelijk in de container gemount. Dat is de belangrijkste technische aanwijzing in deze thread uit juni 2025: Syncthing schreef naar het wegwerpbare bestandssysteem van de container, omdat de verwachte FileDrop-bindmount ontbrak in docker inspect.

De thread is op de oorspronkelijke ZimaOS-installatie nooit opgelost: de gebruiker stapte uiteindelijk over op Debian/CasaOS. Het artikel moet de diagnose daarom gebruiken zonder te doen alsof de oorspronkelijke configuratie is hersteld.

De UI-configuratie en de actieve container kwamen niet overeen

ZimaOS Syncthing-volumetoewijzingen, inclusief FileDrop naar /FileDrop
De gebruiker dacht dat FileDrop aan de container was gekoppeld, maar docker inspect liet later zien dat deze mount ontbrak. Bron: IceWhale Community Forum.

Het appformulier van ZimaOS toonde een FileDrop-toewijzing, maar docker inspect big-bear-syncthing vermeldde deze mount niet. Dat verklaart waarom Syncthing /FileDrop in zijn eigen beschrijfbare containerlaag aanmaakte.

overlay2 is een waarschuwing voor permanente synchronisatiegegevens

Bestanden onder .docker/overlay2/.../diff/FileDrop bevinden zich in het bestandssysteem van de container. Als de container opnieuw wordt aangemaakt of vervangen, kan die laag verloren gaan. Gesynchroniseerde gegevens horen op een permanente bindmount of in een benoemd volume te staan.

De huidige ZimaOS Syncthing-handleiding documenteert nu een ondersteunde installatiestroom, inclusief het mappad en de PUID- en PGID-waarden.

/DATA en /media/ZimaOS-HD waren dezelfde opslagroot

Terminal die toont dat ZimaOS-HD een symbolische koppeling naar /DATA is
IceWhale liet zien dat /media/ZimaOS-HD en /DATA in die opstelling naar dezelfde ZimaOS-opslagroot verwezen. Bron: IceWhale Community Forum.

IceWhale verduidelijkte dat /media/ZimaOS-HD op dat systeem naar /DATA verwees. De padalias zelf was daarom niet de belangrijkste verklaring voor het belanden van bestanden in overlay2.

De echte vraag is of de exacte hostmap in de Mounts-lijst van de container staat, met het verwachte doelpad aan de containerzijde.

Gebruik de huidige mapregels van Syncthing

De huidige officiële handleiding adviseert een speciale Syncthing-map te gebruiken, de juiste PUID- en PGID-waarden in te stellen en doelmappen voor deze workflow via Syncthing aan te maken in plaats van handmatig via de bestandsbrowser van ZimaOS.

De Syncthing-implementatiehandleiding biedt de bredere context voor de opslagindeling.

Samenvatting

Als gesynchroniseerde bestanden in Docker overlay2 terechtkomen, stop dan met het debuggen van de peerverbinding van Syncthing en controleer de containermounts. Zorg dat de doelmap op de host daadwerkelijk is gemount, gebruik in Syncthing het pad aan de containerzijde, stem PUID en PGID af op de schrijfrechten van de hostmap en maak de app opnieuw aan als de opgeslagen UI-definitie niet overeenkomt met de actieve container.