Immich toont verouderde gegevens na een wijziging van het opslagpad

Eva Wong is de Technisch Schrijver en en vaste knutselaar bij ZimaSpace. Een levenslange geek met een passie voor homelabs en open-source software, zij is gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva gelooft dat zelf-hosting leuk moet zijn, niet intimiderend. Met haar tutorials stelt ze de community in staat om hardware-setup te ontrafelen, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Verouderde Immich-gegevens na een wijziging van het opslagpad hebben drie verschillende oorzaken die niet met elkaar mogen worden verward: een verplaatsing van de beheerde medialocatie, een wijziging van het importpad van een externe bibliotheek of een client die nog steeds een gecachte status weergeeft. Moderne Immich-releases kunnen een verplaatste beheerde medialocatie synchroniseren wanneer de geconfigureerde medialocatie en de volumekoppeling consistent blijven, terwijl verplaatsingen van externe bibliotheken nog steeds als nieuwe asset-identiteiten kunnen worden behandeld.

Bewaar het oude pad en de database voordat je opnieuw scant. Controleer eerst welk pad de actieve container ziet en bepaal vervolgens of de serverrecord van Immich onjuist is of slechts één client verouderde gegevens toont. Dat onderscheid bepaalt of je een koppeling moet herstellen, een stabiel containerzichtbaar pad moet terugzetten, een testsubset opnieuw moet scannen of alleen de clientcache moet wissen.

Maak onderscheid tussen een verplaatsing van de beheerde medialocatie en een verplaatsing van een externe bibliotheek

Als je de hostlocatie voor door Immich beheerde uploads hebt gewijzigd, controleer dan of de effectieve instelling voor de medialocatie en de koppeling tussen host en container samen zijn aangepast. Een moderne verplaatsing van beheerde media moet niet op dezelfde manier worden onderzocht als het hernoemen van het importpad van een externe bibliotheek.

De kaart van de persistente Immich-status van ZimaSpace is hierbij nuttig, omdat de database en bestandssysteempaden samen één herstelgrens vormen. De juiste bestanden op de host zijn niet voldoende als de container ergens anders is aangekoppeld.

Als de beheerde medialocatie niet overeenkomt, corrigeer dan eerst de omgevingsinstellingen en volumekoppeling en start de service opnieuw voordat je bibliotheektaken uitvoert. Als het gewijzigde pad bij een externe bibliotheek hoort, laat de database intact en test die situatie afzonderlijk.

Houd het containerpad van de externe bibliotheek waar mogelijk stabiel

Voor een externe bibliotheek is een verplaatsing van opslag aan de hostzijde het veiligst wanneer het importpad dat voor de container zichtbaar is ongewijzigd kan blijven. Als het pad dat aan Immich wordt aangeboden verandert, noteer dan vóór een scan een kleine set asset-ID's, albums, personen en oude paden, zodat je kunt vaststellen of bestaande assets opnieuw zijn gekoppeld of opnieuw zijn aangemaakt.

In een rapport over een padwijziging van een externe bibliotheek in Immich werden verplaatste bestanden als nieuwe assets behandeld, met herverwerking en verlies van relaties die alleen in Immich bestonden. Het betreft een versiegebonden geval, maar het ondersteunt de voorzichtige regel dat een gewijzigd pad van een externe bibliotheek niet automatisch als een transparante naamswijziging wordt behandeld.

Als een testsubset als nieuwe assets verschijnt terwijl de oude records ontbreken of naar de prullenbak zijn verplaatst, stop dan de volledige herscan. Zet indien praktisch het oude, voor de container zichtbare pad terug of gebruik een migratieaanpak die bij de versie past; herschrijf productie-databasepaden niet handmatig zonder een geteste back-up.

Verwar deze situatie niet met een migratie van de Storage Template voor door Immich beheerde bestanden. Het symptoom kan er in de tijdlijn vergelijkbaar uitzien, maar het eigendom van de bestanden en het ondersteunde migratiepad verschillen.

Scheid opgeslagen serverpaden van de clientcache

Bekijk hetzelfde bekende asset in de webclient en in een andere geauthenticeerde client en vergelijk dit met de serverlogboeken of het pad dat voor de server zichtbaar is. Als servertaken nog steeds het oude pad vermelden, kan het wissen van een browsercache de onderliggende record niet herstellen.

Een later probleem met metadata van een oud pad in Immich liet zien dat de verwerking na een naamswijziging nog steeds naar een eerder pad van een externe bibliotheek verwees. Dat is sterk bewijs om eerst de paden van taken te controleren voordat je de mobiele of webinterface de schuld geeft.

Als het serverpad correct is maar slechts één webweergave verouderde gegevens toont, vernieuw of wis dan de cache van die client en test het oorspronkelijke bestand opnieuw. Gecachte miniaturen en een verouderde clientstatus kunnen een correct werkende server defect laten lijken, terwijl een gecachte voorbeeldweergave een defect serverpad juist gezond kan laten lijken.

-15% OFF
Single board computer zimaboard2

Herstel de kleinst mogelijke padgrens en valideer een gecontroleerde herscan

Voer één omkeerbare correctie uit: synchroniseer de instelling voor beheerde media met de koppeling, zet het vorige containerpad van de externe bibliotheek terug, corrigeer een importpad of wis de cache van één client. Maak een databaseback-up voordat je een handeling uitvoert die ertoe kan leiden dat een grote bibliotheek opnieuw wordt ontdekt.

Voer de kleinst haalbare herscan uit en controleer of bestaande records gekoppeld blijven, fouten met oude paden stoppen en er geen dubbele oude en nieuwe assets verschijnen. Open vervolgens enkele originele bestanden, controleer de relaties met albums en personen, voer een zoekopdracht uit en start de stack opnieuw.

Schaal het onderzoek op als records met oude en nieuwe paden tegelijk actief blijven, een grote externe bibliotheek onverwacht opnieuw wordt verwerkt of relaties verdwijnen terwijl de originelen leesbaar blijven. Bewaar de exacte koppelingsoverzicht vóór en na de wijziging, de Immich-versie, de betrokken asset-ID's, het gedrag van hoofdlettergevoeligheid van het bestandssysteem en het tijdstip van de databaseback-up.

Ondersteuning & Tips

Meer om te lezen

Dubbele taken of imports in Immich voorkomen
Sep 08, 2026

Dubbele taken of imports in Immich voorkomen

Scheid herhaalde taken van dubbele assets. Gebruik één canoniek ingestiepad, beheer retries en padwijzigingen en test vervolgens opnieuw invoeren op een kleine groep.

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.