User Tools

Site Tools


homelab:besluiten:26.012-limiteren_ram_containers

This is an old revision of the document!


26.012 Limiteren RAM containers

  • Aangemaakt: 2026-10-19
  • Context / Aanleiding:
    • 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 2026-10-18, op basis van gemeten gebruik (docker stats), ook voor de meeste andere containers limieten gezet.
    • Containers zonder limiet beoordelen (zie tabel: Beszel, Beszel-Agent, docker-iperf3, OmniTools, WUD, Pi-hole, Portainer)
    • Limiet van Dozzle (3g) is ruim ten opzichte van het gebruik (ca. 15 MiB)
    • Evaluatie na enkele weken (zie Evaluatie)

Relaties

Gerelateerd besluit: 26.009 (updatebeleid containers, waarin de limieten zijn uitgerold).

Besluit

  • Gekozen optie:
    • Elke container krijgt waar zinvol een mem_limit in de compose van zijn stack (Portainer), ruim boven het normale gebruik (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. (joplin-indexer heeft restart: no en stopt dus gewoon.)
    • CPU: cpu_shares (relatief gewicht, standaard 1024). cpus werkt niet op de DS423+ (kernel zonder CPU CFS-scheduler, Portainer geeft dan een 500-fout).
    • Limieten per container (gebruik uit docker stats op 2026-10-18, limieten uit de compose-bestanden op 2026-10-19):
Stack Container Gebruik mem_limit cpu_shares
3 Joplin ca. 186 MiB 1g
3 Joplin-DB ca. 158 MiB 1g 1024
4 Homepage ca. 122 MiB 512m 768
20 Dozzle ca. 15 MiB 3g 768
20 Beszel ca. 17 MiB geen
20 Beszel-Agent ca. 12 MiB geen
20 docker-iperf3 ca. 1,4 MiB geen
23 OmniTools ca. 3 MiB geen
37 prowlarr ca. 115 MiB 512m 256
37 qbittorrent ca. 20 MiB 512m 512
37 radarr ca. 166 MiB 1024m 512
37 sabnzbd ca. 56 MiB 512m 512
37 sonarr ca. 183 MiB 1024m 512
37 plex ca. 88 MiB 4096m 1024
37 seerr ca. 130 MiB (als Overseerr, vóór de overstap) 512m 256
42 ghostfolio-db ca. 14 MiB 512m
42 ghostfolio-app ca. 199 MiB 1g
42 ghostfolio-redis ca. 2,5 MiB 256m
48 WUD ca. 89 MiB geen
50 dokuwiki ca. 35 MiB 256m
53 nicotine ca. 80 MiB 512m
55 Pi-Hole ca. 65 MiB geen
58 qdrant ca. 40 MiB 2g
58 anythingllm ca. 273 MiB 2g
58 joplin-indexer piek ca. 2,5 GiB tijdens indexeren 4g 256
60 beatport-tagger ca. 74 MiB 2g (memswap_limit 2g)
(geen stack) portainerdsm ca. 32 MiB geen

* Motivatie:

  • Zonder limiet kan één lekkende container de hele NAS vertragen (zoals op 2026-10-05).
  • Alleen limieten op containers met een bekend probleem is minder werk, maar een lek in een andere container wordt dan pas gemerkt als de NAS traag is.
  • De meeste containers gebruiken weinig (minder dan 200 MiB); er is veel ruimte, dus een ruime limiet kost weinig.

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.
  • Risico’s / aandachtspunten:
    • 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

  • Ervaring:
    • Nog op te doen.
  • Wanneer herbeoordelen:
    • Rond 2026-11-16: controleren of er containers zijn herstart door de limiet, met docker inspect <naam> --format '{{.State.OOMKilled}} {{.RestartCount}}' of in Beszel.
  • Aanleiding voor herziening:
    • 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.1792503834.txt.gz · Last modified: by miels