Zum Inhalt springen

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 prune auf dem Host ausführt.

So verhindern Sie den Fehler

  1. Protokollieren Sie df -h am Anfang und Ende jedes speicherintensiven Jobs, damit das Wachstum über die Zeit sichtbar wird.
  2. Setzen Sie kleinere Basis-Images ein und verwenden Sie mehrstufige Dockerfiles, die nur das fertige Artefakt kopieren.
  3. Führen Sie in Jobs, die mehr als ein Image bauen, zwischen den Build-Stufen ein Docker-Prune aus.
  4. Beschränken Sie Caches auf die Verzeichnisse der Paketdownloads, nicht auf ganze Build-Bäume.
  5. 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.