====== 26.012 Limiteren RAM containers ====== * **Wat**: De regel dat elke container een geheugenlimiet krijgt, zodat één lekkende container de NAS niet kan vertragen. * **Datum**: 2026-10-19 * **Betreft**: [[homelab:devices:synology_ds423|Synology DS423+]], [[homelab:services:joplin|Joplin]], [[homelab:services:homepage|Homepage]], [[homelab:services:dozzle-beszel|Dozzle, Beszel en iperf3]], [[homelab:services:omnitools|OmniTools]], [[homelab:services:arr-stack|Arr-stack]], [[homelab:services:plex|Plex]], [[homelab:services:ghostfolio|Ghostfolio]], [[homelab:services:wud|WUD]], [[homelab:services:docuwiki|DokuWiki]], [[homelab:services:nicotine|Nicotine+]], [[homelab:services:pi-hole|Pi-hole]], [[homelab:services:localsearchai|localsearchai]], [[homelab:services:beatport-tagger|beatport-tagger]], [[homelab:services:portainer|Portainer]], [[homelab:besluiten:26.009-updatebeleid_containers_wud|26.009]] (updatebeleid, waarin de limieten zijn uitgerold) * **[[resources:metadata:tags:status|Status]]**: {{tag>concept}} * **Thema's**: {{tag>container}} /* Beschikbare thematags (kies er 0 of meer, gescheiden met een spatie): backup bandbreedte container, vm dns, firewall, vpn guest, iot, lan, servers multi-user Uitleg en "Bij wijziging": resources:metadata:tags:thema Nieuwe tag? Maak een tagpagina en werk deze lijst bij in de templates voor services, devices en besluiten. */ ===== Context ===== * Op 2026-10-05 reageerde Synology Drive traag: het RAM van de NAS (18 GB) zat op 90%, doordat beatport-tagger 5,7 GB gebruikte terwijl hij niets deed (waarschijnlijk een geheugenlek). * Een limiet van 2g (plus ''memswap_limit'') bracht het gebruik direct terug naar 49%. * Bij de uitrol van het updatebeleid ([[homelab:besluiten:26.009-updatebeleid_containers_wud|26.009]]) zijn op basis van gemeten gebruik (''docker stats'') ook voor de meeste andere containers limieten gezet. ===== Opties ===== * **Gekozen: een limiet op elke container waar dat zinvol is**, ruim boven het normale gebruik. De meeste containers gebruiken weinig (minder dan 200 MiB), dus een ruime limiet kost weinig. * **Afgewezen: alleen limieten op containers met een bekend probleem**: minder werk, maar een lek in een andere container wordt dan pas gemerkt als de NAS traag is. ===== Besluit ===== * **Elke container krijgt waar zinvol een ''mem_limit'' in de compose van zijn stack (Portainer), ongeveer 2× het piekverbruik.** * Een container die zijn limiet raakt wordt gestopt en, afhankelijk van de restart-policy, herstart. De rest van de NAS merkt daar niets van. Voorbeeld: beatport-tagger kreeg 2g met ''memswap_limit'' 2g. ''joplin-indexer'' heeft ''restart: no'' en stopt dus gewoon. * **CPU: ''cpu_shares''** (relatief gewicht, standaard 1024) in plaats van ''cpus''. Reden: ''cpus'' werkt niet op de DS423+ (de kernel heeft geen CPU CFS-scheduler, Portainer geeft dan een 500-fout). * Het gebruik en de limieten per container staan bij Resources op de pagina van de service (zie Betreft). ===== Gevolgen ===== * **Technisch**: * Een limiet die te laag is geeft een afgebroken container (out-of-memory) en een herstart. * Limieten staan in de compose van elke stack (Portainer) en gaan verloren als een container buiten de stack om wordt aangepast. * **Operationeel**: * Bij een nieuwe container: gebruik meten (''docker stats'' of Beszel) en een limiet van ongeveer 2× het piekverbruik in de compose zetten. * Bij een nieuwe versie die meer geheugen vraagt, de limiet aanpassen. * Controleren of een container door zijn limiet is herstart: ''%%docker inspect --format '{{.State.OOMKilled}} {{.RestartCount}}'%%'' of in Beszel. * **Risico's**: * Een kortstondige piek (zoals ''joplin-indexer'' met ca. 2,5 GiB tijdens het indexeren) kan boven een te krappe limiet komen; daarom heeft die 4g. * Containers zonder limiet blijven kwetsbaar voor een geheugenlek. ===== Evaluatie ===== * Wanneer heroverwegen: * Een container die herhaaldelijk tegen zijn limiet aanloopt. * De NAS wordt weer traag door RAM-gebruik. * Nieuwe containers die zonder limiet zijn gestart.