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.
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

Hoe optimaliseer je Immich-databaseverbindingen voor gelijktijdige containers?
Verhoog max_connections niet als eerste. Meet de Immich-sessies, tel de vraag van elke container bij elkaar op, behoud ruimte voor beheerders en stem alleen...

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.

Immich herstellen nadat het databasevolume vol raakt
Verwijder nooit PostgreSQL-WAL om ruimte vrij te maken. Stop schrijfbewerkingen van Immich, behoud de databasestatus, voeg veilig extra opslagcapaciteit toe, herstel PostgreSQL en voorkom...

