User Tools

Site Tools


homelab:besluiten:26.012-limiteren_ram_containers

26.012 Limiteren RAM containers

/

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_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 <naam> --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.
homelab/besluiten/26.012-limiteren_ram_containers.txt · Last modified: by 127.0.0.1