Immich-cache en tijdelijke opslag configureren

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.

Configureer de cache en tijdelijke opslag van Immich door eerst de duurzame bibliotheekstatus te scheiden van gegenereerde afgeleiden, herbruikbare modelcache en echt wegwerpbare tijdelijke containergegevens.

Miniaturen en gecodeerde video's kunnen als cache aanvoelen omdat Immich ze opnieuw kan genereren, maar het zijn persistente werkbestanden die groot kunnen worden en veel tijd en middelen kunnen kosten om opnieuw op te bouwen. Modeldownloads hebben een andere levenscyclus, terwijl logboeken en tijdelijke gegevens in de beschrijfbare laag niet ongemerkt de opstartschijf mogen vullen. Wijs opslag toe op basis van de rol en test daarna het opruim- en herstartgedrag.

Classificeer elke opslagrol voordat je deze verplaatst

Maak een inventaris met ten minste vier categorieën: originelen en vereiste applicatiestatus; gegenereerde miniaturen en voorbeelden; gegenereerde gecodeerde video's; en model-, logboek- of tijdelijke runtimegegevens. Noteer voor elke categorie het huidige pad, de grootte, groeisnelheid, het back-upbeleid, de kosten van opnieuw opbouwen en de service die ernaar schrijft.

Een gebruikersrapport over groei van gegenereerde miniaturen en video's laat zien waarom miniaturen en gecodeerde video afzonderlijk moeten worden gemeten. Individuele verhoudingen zijn niet universeel, omdat de mediaverdeling en verwerkingsinstellingen de geproduceerde hoeveelheid beïnvloeden.

Noem een map niet alleen “cache” omdat het verwijderen ervan ruimte vrijmaakt. Als het verlies ervan dagenlange regeneratie veroorzaakt, actieve weergave verbreekt of status verwijdert die je herstelplan verwacht te behouden, verdient de map een expliciete persistente rol, zelfs als de applicatie deze technisch opnieuw kan maken.

Plaats gegenereerde gegevens met veel activiteit waar latentie en slijtage bij passen

Miniaturen en voorbeelden worden gebruikt voor interactief bladeren en omvatten vaak veel kleine leesbewerkingen, terwijl gecodeerde video's veel grotere sequentiële capaciteit kunnen verbruiken. Een snelle SSD kan activiteiten met veel afgeleide bestanden verbeteren, maar alleen als het verplaatsen van die rol de gemeten wachttijd wegneemt en niet een ander klein volume creëert dat onverwacht volloopt.

De uitleg van ZimaSpace over groei van miniatuuropslag biedt een algemene opslagles: actieve applicatieopslag kan vollopen, zelfs als originelen elders staan. Immich-specifieke paden verschillen, maar de vereiste om de daadwerkelijk beschrijfbare rol te monitoren blijft hetzelfde.

Als bulkmedia op HDD- of NAS-opslag blijft staan terwijl afgeleide bestanden naar een SSD worden verplaatst, monitor dan zowel de minimale vrije ruimte als elke koppeling na een herstart. Een snelle laag voor afgeleide bestanden is alleen nuttig als deze groot genoeg is voor normale groei en een defect ervan niet kan worden verward met verlies van de gezaghebbende originelen.

Bewaar de modelcache bewust, maar behandel deze als opnieuw opbouwbaar

Machinelearningmodellen worden gedownload of voorbereid voor herhaalde inferentie en kunnen aanzienlijke opslagruimte innemen. Door de modelcache te bewaren voorkom je onnodige downloads en opstartwerk, vooral bij tragere verbindingen, maar verwar deze niet met de database of de originelen van je gezin in de herstelhiërarchie.

Een communitydiscussie over de opslagarchitectuur van Immich laat zien waarom beheerders snelle, cacheachtige gegevens scheiden van bulkfoto-opslag. Gebruik zulke indelingen alleen als voorbeelden; controleer de huidige paden en koppelingen in je eigen Compose-definitie voordat je iets verplaatst.

Als de modelcache verloren gaat, bestaat het aanvaardbare herstel normaal gesproken uit het opnieuw maken of downloaden ervan, op voorwaarde dat de service de vereiste bron kan bereiken en voldoende schijfruimte heeft. Documenteer dat gedrag, zodat een back-uptool niet per ongeluk schaarse externe back-upruimte gebruikt om een grote opnieuw op te bouwen cache te beschermen.

-15% OFF
Single board computer zimaboard2

Beperk beschrijfbare lagen, logboeken en tijdelijke ruimte

Beschrijfbare containerlagen mogen geen ongedocumenteerde opslagplaats worden voor persistente afgeleide bestanden, tijdelijke transcoderingen of grote logboeken. Controleer het Docker-schijfgebruik en de containermounts, zodat elk groot groeiend pad bewust persistent wordt gemaakt of opzettelijk wegwerpbaar is. Een onverklaarde piek in de beschrijfbare laag is standaard een configuratiesymptoom, geen opruimdoel.

De Docker HQ-werkwijze uit 2026 voor veilig opruimen van Docker-schijfgebruik benadrukt controle vóór het verwijderen en het beschermen van volumes die databases kunnen bevatten. Pas die voorzichtigheid hier toe: voer nooit algemene opruimopdrachten uit op een productieve Immich-host voordat bekend is wie eigenaar is van elk volume en elke laag.

Stel logrotatie in, houd tijdelijke paden op opslag met voldoende piekruimte en monitor zowel inode- als bytegebruik wanneer er veel kleine bestanden worden gemaakt. Als een tijdelijk pad volloopt, is de juiste oplossing om die rol te begrenzen of te verplaatsen, niet om onbekende mappen te verwijderen totdat de applicatie toevallig weer start.

Valideer opslagwijzigingen met tests voor herstart, opnieuw opbouwen en vrije ruimte

Open na het wijzigen van paden oude en recente bestanden, blader door meerdere albums, speel een video af, voer één miniatuur- of machinelearningtaak uit en upload een gecontroleerd nieuw bestand. Controleer of schrijfbewerkingen op de bedoelde apparaten terechtkomen en of de database nog steeds naar leesbare media verwijst.

Herstart de containers en daarna de host. Een geslaagde configuratie koppelt elke rol automatisch opnieuw, behoudt de verwachte afgeleide bestanden en modelcache, houdt tijdelijke gegevens wegwerpbaar en rapporteert voldoende vrije ruimte op elke actieve laag. Observeer de opslag gedurende een normale werkbelasting om te bevestigen dat groei op de geplande plaats verschijnt.

Draai een padwijziging terug als Immich dubbele mappen aanmaakt, ontbrekende bestanden meldt of stilletjes naar de containerlaag schrijft omdat een koppeling is mislukt. Lever bij escalatie de mountoverzichten, padgroottes, eigenaarschap, vrije ruimte op het bestandssysteem, het schijfgebruik van containers en de exacte taak aan die als eerste naar de verkeerde locatie schreef.

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.