Linux-Arbeitsspeicher voll: Swap und OOM-Killer
Prozesse werden „Killed“, der Server friert ein? So liest Du free -h richtig, findest den Speicherfresser, prüfst den OOM-Killer, richtest Swap ein.
Von Nathan Base
Ein Skript bricht ohne Fehlermeldung mit dem Wort Killed ab, ein Container startet ständig neu, oder der Raspberry Pi reagiert minutenlang nicht mehr auf SSH und ist danach wieder da. Hinter allen drei Fällen steckt oft dasselbe: Der Arbeitsspeicher ist voll, und der Kernel hat einen Prozess beendet, um das System zu retten. Hier siehst Du, wie Du den Speicher richtig liest, den Verursacher findest, den Eingriff des Kernels im Protokoll nachweist und mit Swap und Speicherlimits dafür sorgst, dass es nicht wieder passiert.
Die Befehle gelten für Ubuntu 24.04 und 26.04, Debian 13 und Raspberry Pi OS auf Basis von Trixie. Ich habe sie mit der offiziellen Dokumentation von Kernel, util-linux, Raspberry Pi und Docker abgeglichen.
Speicher richtig lesen: available statt free
Der erste Blick geht zu free:
free -hDie Ausgabe sieht etwa so aus:
total used free shared buff/cache available
Mem: 7.8Gi 2.1Gi 312Mi 45Mi 5.6Gi 5.7Gi
Swap: 2.0Gi 0B 2.0GiViele erschrecken über die Spalte free mit nur 312 MB. Das ist aber kein Problem, denn Linux nutzt ungenutzten Arbeitsspeicher als Zwischenspeicher für Dateien (buff/cache). Diesen Page Cache gibt der Kernel sofort wieder frei, sobald ein Programm Speicher braucht. Entscheidend ist deshalb die Spalte available: Sie schätzt, wie viel Speicher Programme noch bekommen können, ohne dass ausgelagert werden muss.
Als Faustregel gilt: Solange available deutlich über zehn Prozent von total liegt und in der Zeile Swap kaum etwas belegt ist, hat Dein System genug Speicher. Wird available dauerhaft knapp und wächst used bei Swap stetig, bist Du hier richtig.
Den Speicherfresser finden
Welche Prozesse am meisten Speicher belegen, zeigt ps sortiert nach Speicheranteil:
ps aux --sort=-%mem | head -n 10Wichtig sind die Spalten %MEM (Anteil am gesamten Arbeitsspeicher) und RSS (tatsächlich belegter Speicher in Kilobyte). Die Spalte VSZ kannst Du ignorieren, sie enthält auch reservierten Speicher, der nie benutzt wird.
Für eine laufende Ansicht startest Du top und drückst Shift + M, dann sortiert es nach Speicher. In htop funktioniert dieselbe Taste. Beendet wird beides mit q.
Läuft Docker, lohnt sich zusätzlich ein Blick auf die Container, denn ps zeigt nur die Prozesse darin, nicht welcher Container sie gestartet hat:
docker stats --no-streamDie Spalte MEM USAGE / LIMIT zeigt den Verbrauch jedes Containers. Typische Kandidaten sind Datenbanken, Java-Anwendungen, Browser-Automatisierung, lokale KI-Modelle und Node.js-Prozesse mit einem Speicherleck, deren Verbrauch über Stunden langsam ansteigt.
Hat der OOM-Killer zugeschlagen?
Wenn der Kernel keinen Speicher mehr findet, wählt der OOM-Killer (Out of Memory) einen Prozess aus und beendet ihn. Bevorzugt trifft es den Prozess, der am meisten Speicher belegt. Das hinterlässt eine eindeutige Spur im Kernel-Protokoll:
journalctl -k | grep -i "out of memory"Ein Treffer sieht so aus:
Out of memory: Killed process 2817 (python3) total-vm:3412208kB, anon-rss:2984112kB, ...In Klammern steht der Name des beendeten Prozesses, anon-rss zeigt, wie viel Speicher er zuletzt belegt hatte. Beginnt die Zeile mit Memory cgroup out of memory, war der Speicher nicht systemweit voll, sondern ein Container oder Dienst hat sein eigenes Limit erreicht. Das ist der typische Fall bei Docker: Der Container endet mit dem Exit-Code 137. Wie Du solche Container weiter untersuchst, steht in Docker-Container startet nicht: Logs und Exit-Codes.
Hängt sich der Rechner auf und Du startest ihn danach neu, steht der Eintrag im Protokoll des vorherigen Starts. Das liest Du mit journalctl -k -b -1, sofern das Journal dauerhaft gespeichert wird. Wenn journalctl nichts liefert, zeigt sudo dmesg -T | grep -i "killed process" die Meldungen seit dem letzten Start. Mehr zu den Filtern findest Du in journalctl: Fehler unter Linux in den Logs finden.
Findest Du gar nichts, das System war aber trotzdem minutenlang eingefroren, hat es meist ausgelagert, bis nichts mehr ging. Dann bringt Swap allein wenig, und Du musst beim Verursacher ansetzen.
Swap prüfen
Swap ist Auslagerungsspeicher. Er fängt Spitzen ab und gibt selten genutzte Speicherseiten an die Festplatte oder an einen komprimierten Bereich im RAM ab. Welcher Swap aktiv ist, zeigt:
swapon --showSteht dort /dev/zram0, nutzt das System komprimierten Swap im Arbeitsspeicher. Ein Eintrag wie /swap.img oder /swapfile mit dem Typ file ist eine Auslagerungsdatei auf dem Datenträger. Gibt der Befehl gar nichts aus, hat das System keinen Swap. Das ist bei vielen Cloud-Servern und VPS ab Werk so und der häufigste Grund, warum dort schon eine kurze Lastspitze einen Prozess beendet.
Swap-Datei auf Ubuntu und Debian anlegen
Auf einem Server mit 1 bis 4 GB RAM ist eine Swap-Datei von 2 GB ein guter Startwert. Prüf vorher mit df -h /, dass genug Platz frei ist, und mit swapon --show, dass es /swapfile nicht schon gibt.
Zuerst legen wir die Datei an. Die Handbuchseite von swapon empfiehlt dafür dd, weil Dateien aus fallocate je nach Dateisystem abgelehnt werden:
sudo dd if=/dev/zero of=/swapfile bs=1M count=2048 status=progresscount=2048 steht für 2048 Megabyte, also 2 GB. Danach darf nur root die Datei lesen, sonst könnten andere Nutzer ausgelagerte Daten einsehen:
sudo chmod 600 /swapfileJetzt formatieren wir die Datei als Swap und schalten sie ein:
sudo mkswap /swapfile
sudo swapon /swapfileswapon --show zeigt die neue Datei jetzt mit 2G an. Damit sie auch nach einem Neustart aktiv ist, trägst Du sie in /etc/fstab ein. Öffne die Datei mit sudo nano /etc/fstab, füge am Ende diese Zeile hinzu, speichere mit Strg + O und Enter und schließe mit Strg + X:
/swapfile none swap sw 0 0Ob die Zeile stimmt, prüfst Du ohne Neustart mit sudo findmnt --verify. Meldet der Befehl keine Fehler, ist der Eintrag in Ordnung.
Hinweis für Btrfs: Auf Btrfs braucht eine Swap-Datei das Attribut nocow. Ubuntu und Debian nutzen standardmäßig ext4, dort funktioniert der Weg oben ohne Änderung.
Swap auf dem Raspberry Pi
Raspberry Pi OS auf Basis von Trixie verwaltet den Swap mit dem Paket rpi-swap, das den älteren Dienst dphys-swapfile ersetzt. Ob es bei Dir installiert ist, zeigt apt policy rpi-swap. Ab Werk richtet es komprimierten Swap über zram ein und schreibt selten genutzte Seiten nur gelegentlich in eine Datei unter /var/swap. Das schont die SD-Karte, deshalb solltest Du hier keine eigene Swap-Datei mit dd anlegen.
Die Größe des zram-Bereichs richtet sich nach dem Arbeitsspeicher und ist laut Handbuchseite swap.conf standardmäßig auf 2048 MiB begrenzt. Brauchst Du mehr, legst Du eine Ergänzungsdatei an:
sudo mkdir -p /etc/rpi/swap.conf.d
sudo nano /etc/rpi/swap.conf.d/50-mehr-zram.confTrag in die Datei diese zwei Zeilen ein und speichere wie oben:
[Zram]
MaxSizeMiB=4096Die Änderung wirkt erst nach einem Neustart mit sudo reboot, denn rpi-swap richtet den Swap ganz früh beim Systemstart ein. Danach zeigt swapon --show das größere zram-Gerät. Mehr als das Doppelte des Arbeitsspeichers solltest Du nicht einstellen, weil schlecht komprimierbare Daten sonst den gesamten RAM belegen können.
Auf älteren Systemen mit Bookworm läuft noch dphys-swapfile. Dort änderst Du in /etc/dphys-swapfile den Wert CONF_SWAPSIZE, etwa auf CONF_SWAPSIZE=1024, und startest den Dienst mit sudo systemctl restart dphys-swapfile neu. Weitere Einstellungen, die einen Pi im Dauerbetrieb stabil halten, sammelt Raspberry Pi im Dauerbetrieb: SD-Karte schonen, stabil laufen.
swappiness: wie früh ausgelagert wird
Der Wert vm.swappiness legt fest, wie bereitwillig der Kernel Speicherseiten auslagert, statt den Datei-Cache zu verkleinern. Erlaubt sind laut Kernel-Dokumentation 0 bis 200, Standard ist 60. Den aktuellen Wert liest Du mit:
sysctl vm.swappinessFür die meisten Systeme passt der Standard. Liegt der Swap auf einer langsamen Festplatte und reagiert der Server unter Last zäh, kann ein niedrigerer Wert wie 20 helfen. Bei zram gilt laut Kernel-Dokumentation das Gegenteil: Weil komprimierter Swap im RAM schnell ist, sind dort auch Werte über 100 vertretbar. Ändere den Wert nur, wenn Du ein konkretes Problem beobachtest. Dauerhaft setzt Du ihn mit einer eigenen Datei:
echo "vm.swappiness=20" | sudo tee /etc/sysctl.d/99-swappiness.conf
sudo sysctl --systemsysctl --system lädt alle Einstellungsdateien neu, ein Neustart ist nicht nötig.
Vorbeugen: Speicherlimits für Container
Swap verschafft Luft, löst aber kein Speicherleck. Läuft auf dem Server mehr als ein Dienst, ist ein Speicherlimit pro Container der wirksamste Schutz. Erreicht der Container sein Limit, beendet der Kernel nur ihn, statt einen zufälligen anderen Prozess oder den SSH-Dienst zu treffen. In der compose.yaml setzt Du das Limit mit mem_limit:
services:
app:
image: ghcr.io/beispiel/app:latest
restart: unless-stopped
mem_limit: 512mErsetze 512m durch einen Wert, der etwas über dem normalen Verbrauch aus docker stats liegt. Nach docker compose up -d zeigt docker stats --no-stream das neue Limit in der Spalte LIMIT. Ob ein Container später wegen des Limits beendet wurde, verrät:
docker inspect --format '{{.State.OOMKilled}}' meinprojekt-app-1Ersetze meinprojekt-app-1 durch den Containernamen, den docker compose ps in der Spalte NAME anzeigt. true bedeutet, dass das Limit gegriffen hat. Dann ist entweder das Limit zu knapp oder die Anwendung verbraucht mehr, als sie sollte. Wie Compose-Dateien grundsätzlich aufgebaut sind, erklärt Docker Compose verstehen: Volumes, Netzwerke und .env.
Wenn es trotzdem nicht reicht
Steigt der Speicherverbrauch nach jedem Neustart eines Dienstes über Stunden stetig an, liegt ein Speicherleck vor. Ein nächtlicher Neustart des Dienstes per systemd-Timer oder Cronjob ist dann eine brauchbare Übergangslösung, bis ein Update den Fehler behebt.
Reicht der Speicher dagegen schon im Normalbetrieb nicht, hilft nur mehr RAM. Beim Raspberry Pi heißt das, ein Modell mit mehr Arbeitsspeicher zu nehmen, etwa einen Raspberry Pi 5 mit 8 GB (Affiliate Link), denn der RAM ist fest verlötet. Bei einem VPS wechselst Du in einen größeren Tarif.
Das Gegenstück zu diesem Problem ist die volle Festplatte, die sich mit ähnlichen Symptomen bemerkbar macht. Wie Du dort den Platzfresser findest, zeigt Linux-Festplatte voll: große Dateien finden mit ncdu.
Kurz zusammengefasst
Lies bei free -h die Spalte available, nicht free. Den Verursacher findest Du mit ps aux --sort=-%mem oder docker stats, den Eingriff des OOM-Killers mit journalctl -k. Ein Server ohne Swap bekommt eine Swap-Datei von 2 GB, ein Raspberry Pi mit Trixie behält zram und wird bei Bedarf über /etc/rpi/swap.conf.d vergrößert. Und jeder Container bekommt ein Speicherlimit, damit ein einzelner Dienst nicht mehr das ganze System mitreißt.
Weiterlesen.
-
Raspberry Pi & Linuxjournalctl: Fehler unter Linux in den Logs finden
Mit journalctl findest Du heraus, warum ein Dienst streikt oder der Pi neu startet: nach Dienst, Zeit und Priorität filtern, Journal dauerhaft speichern.
Nathan Base -
Selfhosting & WebDocker-Container startet nicht: Logs und Exit-Codes
Docker-Container hängt in „Restarting“ oder beendet sich sofort? So findest Du mit Logs, Exit-Code und Healthcheck die Ursache und behebst sie.
Nathan Base -
Raspberry Pi & LinuxRaspberry Pi im Dauerbetrieb: SD-Karte schonen, stabil laufen
Läuft der Raspberry Pi rund um die Uhr, sterben SD-Karten und Netzteile zuerst. Diese Einstellungen unter Raspberry Pi OS Trixie machen den Pi langlebig.
Nathan Base -
Raspberry Pi & LinuxLinux-Festplatte voll: große Dateien finden mit ncdu
No space left on device? So findest Du unter Linux mit df, du und ncdu die Speicherfresser, räumst sicher auf und löst auch den Fall gelöschter Dateien.
Nathan Base -
Raspberry Pi & Linuxpip: „externally-managed-environment“ richtig lösen
pip install meldet externally-managed-environment? So installierst Du Python-Pakete auf Raspberry Pi, Debian und Ubuntu sauber mit apt, venv oder pipx.
Nathan Base -
Raspberry Pi & LinuxRaspberry Pi 5 zu heiß? Temperatur, Throttling, Kühlung
Wie heiß darf der Raspberry Pi 5 werden? Grenzwerte, Temperatur messen und loggen, Active Cooler oder Gehäuse, Lüfterkurve anpassen und Stresstest.
Nathan Base