Vilken minnesgräns bör du ställa in för Immich?

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Ange inte en enda minnesgräns för Immich utifrån ett universellt GB-tal. Ett mål för RAM-minnet på värddatorn och en gräns per container löser olika problem: värddatorn måste klara hela stacken, medan en containergräns ska skydda värddatorn utan att avsluta en legitim Immich-arbetsbelastning.

Att bläddra i ett färdigbearbetat bibliotek kan verka lätt, medan en kallstart av maskininlärning, en stor import, generering av miniatyrbilder, ansiktsanalys eller videobearbetning kan förbruka mycket mer minne. Mät den tyngsta arbetsbelastning du faktiskt behöver, lämna utrymme för PostgreSQL och operativsystemet och betrakta upprepade OOM-avslutningar som ett tecken på att gränsen inte fungerar, inte som normal begränsning.

Mät minnestrycket innan du väljer gränsen

Registrera minnesanvändningen i tre lägen: lugn bläddring, en representativ daglig uppladdning och den tyngsta planerade bakgrundsbelastningen. Samla in information om containeranvändning, tillgängligt minne på värddatorn, växlingsaktivitet, OOM-händelser och om jobben fortsätter att göra framsteg. En enstaka topp från docker stats räcker inte, eftersom Linux minnesredovisning omfattar flera typer av minne med olika möjligheter att frigöra det.

En användbar uppdelning av Dockers cgroup-minne skiljer mellan anonymt minne, filbackad cache och slab i stället för att behandla totalsumman som lika riskfylld. Stabil filcache med gott om ledigt minne på värddatorn skiljer sig från stadigt ökande anonymt minne, växlingspress eller en OOM-räknare för cgroup som ökar under samma Immich-jobb.

Gå vidare från det här steget när du kan identifiera en återkommande toppnivå och förklara om den främst består av minnescache som kan frigöras eller aktivt arbetsminne. Om användningen fortsätter att öka med en oförändrad arbetsbelastning, en container upprepade gånger avslutas av OOM eller värddatorn börjar använda växlingsutrymmet intensivt, ska du sluta dimensionera utifrån den körningen och först utreda den onormala ökningen.

Dimensionera taket efter den tyngsta giltiga arbetsbelastningen i Immich

Välj vilken arbetsbelastning som måste fortsätta fungera när gränsen har införts. För ett hushåll kan det innebära att fyra telefoner laddar upp medan Smart Search och ansiktsjobben kommer ikapp; för ett annat kan det vara en stor första import följd av vanlig bläddring. Håll datamängden, modellen, inställningarna för samtidighet och övriga containrar oförändrade medan du mäter, så att gränsen motsvarar ett definierat serviceåtagande.

Placera den hårda gränsen ovanför den uppmätta toppen för minne som inte kan frigöras, med tillräcklig uppmätt marginal för korta belastningstoppar, samtidigt som du reserverar värdminne för PostgreSQL, filsystemscache, containermiljön och orelaterade tjänster. Den relaterade checklistan från ZimaSpace för varningstecken på resursbrist vid lokal AI är användbar eftersom värme, växling till disk och plötsliga omstarter avslöjar belastning på värdnivå som en graf som bara visar Immich kan missa. Tolka inte ”containern nådde gränsen en gång” som bevis för att mer RAM behövs. Den viktiga gränsen är om samma giltiga arbetsbelastning blir kraftigt långsammare, förlorar jobb, växlar kontinuerligt till disk eller avslutas av OOM-hanteraren. Omvänt är gränsen för generös om Immich kan svälta databasen eller värden på resurser innan dess egen cgroup sätter gränsen.

Minska arbetsbelastningen innan du höjer en gräns vid onormal tillväxt

Om det föreslagna taket bara slår till vid en viss typ av bakgrundsarbete bör du minska jobbets samtidighet eller isolera steget innan du höjer taket. Maskininlärning, generering av miniatyrbilder, videobehandling och databasarbeten kan ha olika minnesprofiler. En mindre aktiv batch kan bli klar långsammare, men håller gränssnittet hemma responsivt och värden återställningsbar.

Versionsspecifika fel är också viktiga. En minnesrapport om Immich v3.0.3 beskrev en maskininlärningsarbetare som fortsatte att växa tills en cgroup-gräns utlöste OOM efter ett felaktigt tillstånd relaterat till språk och region. Det fallet definierar inte Immichs normala RAM-användning; det visar varför oförklarlig tillväxt bör behandlas som ett programvaru- eller konfigurationsproblem innan värdens minnesbudget höjs permanent.

När du har ändrat en variabel för samtidighet, modell eller version kör du om samma arbetsbelastning. Behåll ändringen bara om både minnesprofilen och det ursprungliga jobbet förbättras i förväntad riktning. Om minnesanvändningen fortfarande ökar utan att närma sig en stabil platå bör du spara loggar och versionsuppgifter och eskalera problemet i stället för att göra den hårda gränsen allt högre.

Validera gränsen efter en kall omstart och en intensiv cykel

Starta om värden så att cache och modellernas minnesanvändning börjar från ett känt kallt tillstånd. Kör de normala kontrollerna för inloggning och surfning, följt av representativ uppladdning och bakgrundsarbetsbelastning. Registrera högsta anonyma minnesanvändning, cache, växlingsutrymme, OOM-räknare, databasens svarstid, tiden det tar för kön att tömmas och om en annan viktig container fortfarande är responsiv.

En godkänd gräns klarar både kallstart och den mest intensiva normala cykeln utan OOM-avslutningar, ihållande växlingsintensiv aktivitet, upprepade omstarter av containrar eller en kö som slutar tömmas. Den bör också lämna tillräckligt med utrymme på värden för återställningsuppgifter, som en databasdump eller administrativ inloggning, när Immich är upptaget.

Om bara ett artificiellt stresstest misslyckas medan alla definierade hushållsarbetsbelastningar fungerar, dokumenterar du den accepterade gränsen i stället för att köpa RAM för ett scenario du inte behöver.

Om en verklig arbetsbelastning inte kan köras utan att värden blir överbelastad kan du minska samtidigheten, isolera maskininlärningen, utöka minnet eller flytta konkurrerande tjänster. Kör sedan samma validering igen innan du bedömer den nya gränsen som säker.

Support och tips

Mer att läsa

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.