Welke geheugenlimiet moet je instellen voor Immich?

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Stel niet voor Immich één geheugenlimiet in op basis van een universeel aantal GB. Een RAM-doel voor de host en een limiet per container lossen verschillende problemen op: de host moet de volledige stack aankunnen, terwijl een containerlimiet de host moet beschermen zonder een legitieme Immich-werklast af te breken.

Door een verwerkte bibliotheek bladeren kan weinig geheugen lijken te kosten, terwijl een koude start van machine learning, een grote import, het genereren van miniaturen, gezichtsherkenning of videobewerking veel meer geheugen kan verbruiken. Meet de zwaarste werklast die je daadwerkelijk nodig hebt, houd ruimte vrij voor PostgreSQL en het besturingssysteem en beschouw herhaalde OOM-beëindigingen als een teken dat de limiet te laag is, niet als normale beperking.

Meet de geheugendruk voordat je de limiet kiest

Registreer het geheugengebruik in drie situaties: rustig door de bibliotheek bladeren, een representatieve dagelijkse upload en de zwaarste geplande achtergrondtaak. Leg het containergebruik, het beschikbare geheugen op de host, swapactiviteit, OOM-gebeurtenissen en de voortgang van taken vast. Eén piekwaarde van docker stats volstaat niet, omdat de geheugenboekhouding van Linux verschillende soorten geheugen omvat die elk op een andere manier kunnen worden vrijgemaakt.

Een nuttige uitsplitsing van Docker-cgroup-geheugen maakt onderscheid tussen anoniem geheugen, cache met bestanden als backing en slab, in plaats van het ruwe totaal als even gevaarlijk te behandelen. Stabiele bestandscache met voldoende geheugenruimte op de host is iets anders dan gestaag stijgend anoniem geheugen, swapdruk of een cgroup-OOM-teller die tijdens dezelfde Immich-taak oploopt.

Slaag voor deze fase wanneer je een herhaalbaar hoogtepunt kunt vaststellen en kunt uitleggen of het voornamelijk om vrij te maken cache of actief werkgeheugen gaat. Als het gebruik blijft stijgen bij een onveranderde werklast, een container herhaaldelijk door de OOM-killer wordt beëindigd of de host intensief begint te swappen, stop dan met het bepalen van de geheugengrootte op basis van die meting en onderzoek eerst de abnormale groei.

Stem de limiet af op de zwaarste geldige Immich-werklast

Bepaal welke werklast ondersteund moet blijven nadat de limiet is ingesteld. Voor het ene huishouden kan dat betekenen dat vier telefoons tegelijk uploaden terwijl Smart Search en gezichtsherkenningstaken hun achterstand inhalen; voor een ander kan het gaan om een grote eerste import, gevolgd door normaal bladeren. Houd de dataset, het model, de instellingen voor gelijktijdigheid en andere containers ongewijzigd tijdens het meten, zodat de limiet is afgestemd op een duidelijk omschreven servicebelofte.

Stel de harde limiet in boven de waargenomen piek van niet-vrij te maken geheugen, met voldoende meetbare marge voor korte pieken, en houd tegelijk geheugen vrij voor PostgreSQL, de bestandssysteemcache, de container-runtime en andere services. De gerelateerde ZimaSpace-checklist voor waarschuwingssignalen voor resources bij lokale AI is nuttig, omdat hitte, wisselen naar schijf en plotselinge herstarts wijzen op belasting van de host die een grafiek van alleen Immich mogelijk niet laat zien. Beschouw “de container heeft de limiet één keer bereikt” niet als bewijs dat er meer RAM nodig is. De belangrijke grens voor problemen is of dezelfde geldige werklast ernstig vertraagt, taken verliest, voortdurend naar schijf wisselt of door de OOM-killer wordt beëindigd. Omgekeerd is een limiet te ruim als Immich de database of de host kan uithongeren voordat de cgroup zelf de grens bereikt.

Verlaag de werklast voordat je een limiet verhoogt bij abnormaal geheugengebruik

Als de voorgestelde limiet alleen wordt overschreden tijdens één soort achtergrondtaak, verlaag dan de gelijktijdigheid van die taak of isoleer de fase voordat je de limiet verhoogt. Machinelearning, het genereren van miniaturen, videoverwerking en databasewerk kunnen verschillende geheugenprofielen hebben. Een kleinere actieve batch is mogelijk langzamer klaar, maar houdt de interface thuis responsief en de host herstelbaar.

Versiespecifieke fouten zijn ook van belang. Een geheugenrapport over Immich v3.0.3 beschreef een machinelearning-worker die steeds meer geheugen gebruikte totdat een cgroup-limiet een OOM veroorzaakte, na een verkeerd geformuleerde, met de landinstelling samenhangende voorwaarde. Dat geval is geen maatstaf voor het normale RAM-gebruik van Immich; het laat zien waarom onverklaarde groei eerst als een software- of configuratieprobleem moet worden onderzocht, voordat je het hostgeheugenbudget permanent verhoogt.

Voer na het wijzigen van één variabele voor gelijktijdigheid, model of versie dezelfde werklast opnieuw uit. Behoud de wijziging alleen als zowel het geheugengedrag als de oorspronkelijke taak in de verwachte richting verbeteren. Als het geheugengebruik blijft stijgen zonder een stabiel plateau te benaderen, bewaar dan de logs en versiegegevens en schaal het probleem op, in plaats van de harde limiet steeds verder te verhogen.

Valideer de limiet na een koude herstart en een drukke cyclus

Herstart de host zodat caches en modelresidentie vanuit een bekende koude toestand beginnen. Voer de normale aanmeldings- en browsecontroles uit, gevolgd door de representatieve upload- en achtergrondwerklast. Noteer het piekgebruik van anoniem geheugen, cache en wisselgeheugen, OOM-tellers, de database-respons, de tijd om de wachtrij leeg te laten lopen en of een andere belangrijke container responsief blijft.

Een werkende limiet houdt stand bij zowel een koude start als de drukste normale cyclus, zonder OOM-beëindigingen, aanhoudend wisselgeheugengeweld, herhaalde containerherstarts of een wachtrij die niet meer leegloopt. Er moet ook voldoende ruimte op de host overblijven voor hersteltaken, zoals een database-export of administratieve aanmelding wanneer Immich druk is.

Als alleen een kunstmatige stresstest mislukt terwijl alle vastgelegde huishoudelijke werklasten slagen, leg dan de geaccepteerde grens vast in plaats van RAM te kopen voor een scenario dat je niet nodig hebt.

Als een realistische werklast niet kan slagen zonder de host uit te putten, verlaag dan de gelijktijdigheid, isoleer machine learning, voeg geheugen toe of verplaats concurrerende services; herhaal daarna dezelfde validatie voordat je de nieuwe limiet veilig verklaart.

Ondersteuning en tips

Meer om te lezen

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.