No Space Left on Device in GitHub Actions: Fixes
Zuletzt aktualisiert am
Der Fehler No space left on device bedeutet, dass die Festplatte des Runners während Ihres Jobs voll gelaufen ist, meist bei einem Docker-Build, einer großen Abhängigkeitsinstallation oder einem umfangreichen Artefakt-Schritt. Die Standard-Linux-Runner von GitHub bieten 14 GB SSD-Speicher. Ein Job, der Images herunterlädt, ein großes Projekt baut und es zwischenspeichert, kann diesen Platz daher aufbrauchen. Im Folgenden finden Sie die Ursachen, nach Häufigkeit sortiert, mit Lösungen zum direkten Übernehmen. Die Angabe zum Speicher stammt aus der Referenz zu den GitHub-gehosteten Runnern, Stand Oktober 2026.
Die genaue Meldung
Im fehlschlagenden Schritt sehen Sie eine der folgenden Meldungen:
System.IO.IOException: No space left on device
ENOSPC: no space left on device, write
write /var/lib/docker/...: no space left on device
OSError: [Errno 28] No space left on device
Der Wortlaut hängt vom Werkzeug ab, die Ursache ist jedoch immer dieselbe: Das Dateisystem hat keine freien Blöcke oder keine freien Inodes mehr. Derselbe Text kann auch auf einem selbst gehosteten Runner auftreten, dessen Festplattengröße Sie selbst festlegen.
Prüfen, was den Speicher belegt
Fügen Sie diesen Schritt vor dem fehlschlagenden und erneut danach ein, um zu sehen, was gewachsen ist:
- name: Disk usage
if: always()
run: |
df -h
sudo du -xh / --max-depth=2 2>/dev/null | sort -rh | head -20
docker system df
Wenn df -h freien Speicher anzeigt, der Fehler aber trotzdem auftritt, prüfen Sie die Inodes mit df -i. Millionen kleiner Dateien in node_modules können die Inodes zuerst erschöpfen.
Ursachen, nach Wahrscheinlichkeit sortiert
1. Docker-Images, Layer und Build-Cache
Jeder docker pull, docker build und Service-Container schreibt nach /var/lib/docker. Mehrstufige Builds mit großen Basis-Images sind dafür meist verantwortlich. Entfernen Sie zwischen den Schritten, was Sie nicht mehr brauchen:
- name: Free Docker space
run: |
docker image prune -af
docker builder prune -af
docker system df
Verwenden Sie docker system prune -af --volumes nur, wenn kein späterer Schritt die Volumes benötigt. Die Docker-Dokumentation zum Prune erklärt, was jeder Befehl entfernt. Kleinere Basis-Images (-slim, -alpine) und eine .dockerignore-Datei reduzieren den Verbrauch ebenfalls. Mehr zum Build-Caching finden Sie unter Docker-Layer-Caching in CI.
2. Vorinstallierte Toolchains, die Sie nicht nutzen
Das gehostete Ubuntu-Image enthält viele SDKs. Wenn Ihr Job weder Android, .NET noch Haskell verwendet, lassen sich durch das Löschen mehrere GB freigeben. Diese Pfade werden häufig entfernt, es handelt sich jedoch um Details des Images, die GitHub ändern kann. Prüfen Sie sie deshalb zuerst mit du:
- name: Free disk space
run: |
sudo rm -rf /usr/share/dotnet
sudo rm -rf /usr/local/lib/android
sudo rm -rf /opt/ghc
sudo rm -rf /opt/hostedtoolcache/CodeQL
df -h /
Das Löschen dauert ein bis zwei Minuten, führen Sie es daher nur aus, wenn Sie das Limit erreichen. Entfernen Sie keine Werkzeuge, die Ihr Job später aufruft. Die Liste der vorinstallierten Software finden Sie im runner-images-Repository.
3. Build-Ausgaben, Caches und Artefakte
Große Verzeichnisse wie target/, build/ oder .gradle sowie wiederhergestellte Caches liegen alle auf derselben Festplatte. Räumen Sie Zwischenergebnisse laufend auf und stellen Sie keine Caches wieder her, die größer sind als nötig (siehe Cache-Limits). Bei Gradle hilft ./gradlew --stop, und nicht benötigte Build-Caches sollten Sie löschen. Bei Rust bringt die Aufteilung des Builds in mehrere Jobs mehr als cargo clean.
4. Zu viel in einem Job
Wer ein großes Monorepo auscheckt, alle Images baut und alle Tests in einem Job ausführt, verteilt den gesamten Speicherverbrauch auf eine einzige Maschine. Teilen Sie die Arbeit auf mehrere Jobs auf oder nutzen Sie eine Test-Sharding-Matrix, damit jeder Job weniger schreibt. Verwenden Sie einen flachen Clone mit fetch-depth: 1, wenn Sie den Verlauf nicht benötigen.
5. Logs und temporäre Dateien aus Tests
Testsuiten, die Videos, Core-Dumps oder ausführliche Logs schreiben, können mehrere GB belegen. Schreiben Sie diese Dateien in ein Verzeichnis, das Sie hochladen und danach löschen, oder reduzieren Sie die Ausführlichkeit.
Lösungen, wenn Aufräumen nicht ausreicht
- Größerer Runner. Die größeren Runner von GitHub bieten mehr Ressourcen als die Standard-Runner. Die aktuellen Größen finden Sie auf der Seite zu den größeren Runnern. Sie werden immer minutengenau abgerechnet, auch bei öffentlichen Repositories.
- Ein anderer Runner-Anbieter. compiler.dev führt denselben Job auf einer Maschine mit 8 vCPU / 16 GB und einer frischen VM pro Job aus. Das hilft auch, wenn Speicherprobleme mit Speicherdruck einhergehen (siehe Exit-Code 137). Die Umstellung erfordert eine Zeile,
runs-on: [self-hosted, Linux, compiler-ci]; Details unter Preise. - Selbst gehosteter Runner. Sie wählen die Festplatte, übernehmen aber auch die Bereinigung. Richten Sie einen geplanten Job ein, der
docker system pruneauf dem Host ausführt.
So verhindern Sie den Fehler
- Protokollieren Sie
df -ham Anfang und Ende jedes speicherintensiven Jobs, damit das Wachstum über die Zeit sichtbar wird. - Setzen Sie kleinere Basis-Images ein und verwenden Sie mehrstufige Dockerfiles, die nur das fertige Artefakt kopieren.
- Führen Sie in Jobs, die mehr als ein Image bauen, zwischen den Build-Stufen ein Docker-Prune aus.
- Beschränken Sie Caches auf die Verzeichnisse der Paketdownloads, nicht auf ganze Build-Bäume.
- Teilen Sie große Jobs auf. Ein Job, der 20 GB benötigt, sind wahrscheinlich zwei Jobs.
Verwandte Fehler: Verbindung zum gehosteten Runner verloren tritt oft auf, wenn einem Runner Ressourcen fehlen, und Cache nicht gefunden erscheint, wenn große Caches verdrängt wurden.
FAQ
Wie viel Festplattenspeicher hat ein GitHub Actions Runner?
GitHub gibt für Standard-Linux-Runner wie ubuntu-latest 14 GB SSD-Speicher an, sowohl für öffentliche als auch für private Repositories, Stand Oktober 2026. Mit df -h in einem Schritt sehen Sie den tatsächlich freien Speicher, der niedriger ausfällt, weil das Betriebssystem und die Werkzeuge einen Teil belegen.
Ist es sicher, /usr/share/dotnet und /usr/local/lib/android zu löschen?
Ja, sofern Ihr Job diese nicht benötigt. Der Runner ist eine frische VM, das Löschen betrifft also nur den aktuellen Job. Führen Sie es aus, bevor Ihr Build startet, und löschen Sie nichts, das eine spätere Aktion braucht.
Warum füllt Docker die Festplatte so schnell?
Layer heruntergeladener Images, Zwischen-Build-Layer und der Build-Cache werden lokal gespeichert. Einige große Images überschreiten schnell mehrere GB. Führen Sie ein Prune aus oder verwenden Sie kleinere Images.
Kann ich einem gehosteten Runner mehr Festplattenspeicher hinzufügen?
Nicht über eine dokumentierte Einstellung für Standard-Runner. Nutzen Sie einen größeren Runner, einen selbst gehosteten Runner oder einen Anbieter, dessen Maschinen größere Festplatten haben.
Verwandt
- Cache Service Responded With 429: So beheben Sie den FehlerFix "Failed to restore: Cache service responded with 429" in GitHub Actions: zu viele Cache-Anfragen. actions/cache aktualisieren, einmal wiederherstellen, einmal speichern.
- fatal: could not read Username for github.com: BehebenBehebe "fatal: could not read Username for 'https://github.com'" in GitHub Actions: Private Repos, Submodules und Git-Abhängigkeiten benötigen einen Token.
- Ungültige Workflow-Datei: YAML-Syntaxfehler beheben"Ungültige Workflow-Datei" und "Fehler in der YAML-Syntax" in GitHub Actions beheben: Einrückung, unerwarteter Wert, fehlerhafte Ausdrücke, mit actionlint.
- JavaScript Heap Out of Memory in GitHub Actions: BehebenBeheben Sie "FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory" und npm ENOMEM in GitHub Actions mit NODE_OPTIONS.