homelab:besluiten:26.012-limiteren_ram_containers
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: Synology DS423+, Joplin, Homepage, Dozzle, Beszel en iperf3, OmniTools, Arr-stack, Plex, Ghostfolio, WUD, DokuWiki, Nicotine+, Pi-hole, localsearchai, beatport-tagger, Portainer, 26.009 (updatebeleid, waarin de limieten zijn uitgerold)
- Thema's:
/
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 (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_limitin 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_limit2g.joplin-indexerheeftrestart: noen stopt dus gewoon. - CPU:
cpu_shares(relatief gewicht, standaard 1024) in plaats vancpus. Reden:cpuswerkt 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 statsof 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 <naam> --format '{{.State.OOMKilled}} {{.RestartCount}}'of in Beszel.
- Risico's:
- Een kortstondige piek (zoals
joplin-indexermet 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.
homelab/besluiten/26.012-limiteren_ram_containers.txt · Last modified: by 127.0.0.1
