Hosted Runner hat die Verbindung zum Server verloren: Lösung
Zuletzt aktualisiert · Erstmals veröffentlicht
Die Fehlermeldung The hosted runner lost communication with the server bedeutet, dass der GitHub-Runner-Prozess während der Ausführung deines Jobs die Verbindung zu GitHub verloren hat. In der Praxis liegt das fast immer daran, dass der Runner-VM der Arbeitsspeicher, die CPU oder der Speicherplatz ausgeht, oder dass ein Schritt den Runner selbst beendet oder blockiert hat. Diese Seite ordnet die Ursachen nach Häufigkeit und zeigt, wie du herausfindest, welche bei dir zutrifft. Passt nichts davon und schlagen viele unabhängige Jobs gleichzeitig fehl, prüfe die GitHub-Statusseite.
Die genaue Meldung
The hosted runner: GitHub Actions 12 lost communication with the server. Anything in your
workflow that terminates the runner process, starves it for CPU/Memory,
or blocks its network access can cause this error.
Die Meldung nennt bereits die typischen Ursachen. Auf einen beendeten gehosteten Runner kannst du dich nicht per SSH verbinden, daher diagnostizierst du anhand von Logs und Ressourcennutzung. Die Maschinenlimits findest du in der Referenz zu GitHub-gehosteten Runnern: Standard-Linux-Runner für private Repositories haben 2 CPUs und 8 GB RAM (Stand Oktober 2026).
Ursachen, nach Wahrscheinlichkeit sortiert
1. Speicher erschöpft
Ein Build- oder Testprozess belegt den gesamten RAM, das System gerät ins Swappen, und der Runner-Agent reagiert nicht mehr. Manchmal siehst du stattdessen Exit-Code 137, manchmal nur diese Meldung. Typische Auslöser sind webpack- oder Next.js-Builds, Jest mit vielen Workern, Gradle oder Maven mit großen Heaps und Docker-Builds, die große Projekte kompilieren.
Speichernutzung zur Bestätigung protokollieren:
- name: Watch memory
run: |
(while true; do date +%T; free -m | sed -n 2p; sleep 10; done) &
- run: npm run build
Wenn der Speicherverbrauch vor dem Fehler nahe am Maximum liegt, reduziere die Parallelität:
- run: npx jest --maxWorkers=2
env:
NODE_OPTIONS: --max-old-space-size=4096
2. Speicherplatz voll
Ein volles Laufwerk kann Tools einfrieren lassen und das eigene Logging des Runners unterbrechen. Prüfe das mit df -h und achte auf No space left on device.
3. CPU-Engpass
Eine Endlosschleife, ein Test, der ohne Begrenzung Prozesse erzeugt, oder zu viele parallele Compiler können dem Runner-Agenten die CPU-Zeit nehmen. Begrenze die Parallelität (make -j2, --workers, GOMAXPROCS) und führe den rechenintensivsten Schritt mit nice aus.
4. Ein Schritt beendet oder verändert den Runner
Skripte, die pkill, killall node, sudo shutdown ausführen, Docker oder Systemdienste stoppen oder eine Firewall aktivieren, können die Verbindung des Runners kappen. Beende Prozesse gezielt über Muster oder PID und fass niemals die Prozesse Runner.Listener oder Runner.Worker an.
- run: pkill -f "my-test-server" # specific, not 'node'
5. Netzwerkänderungen im Job
VPN-Schritte, iptables-Regeln und Änderungen an /etc/hosts können die ausgehende Verbindung des Runners zu GitHub blockieren. Wenn du das unbedingt brauchst, erlaube die Endpunkte von GitHub; die IP-Bereiche findest du in der Meta-API.
6. Self-hosted Runner und Spot-Instanzen
Bei Self-hosted oder automatisch skalierten Runnern kann die VM verdrängt, durch ein Update neu gestartet werden oder die Netzwerkverbindung verlieren. Verwende ephemere Runner, stelle sicher, dass der Host nicht in den Ruhezustand geht, und lies die Logs unter _diag des Runners für die eigentliche Ursache. Die Meldung ist dieselbe, die Behebung betrifft aber deine Infrastruktur.
7. Ein Vorfall bei GitHub
Wenn viele unabhängige Workflows gleichzeitig fehlschlagen, könnte GitHub betroffen sein. Starte die Ausführung erneut, sobald der Vorfall behoben ist.
So diagnostizierst du
- Öffne den fehlgeschlagenen Lauf und notiere den Schritt, der lief, als er abbrach. Dieser Schritt ist der wahrscheinliche Verursacher.
- Aktiviere das Debug-Logging, indem du das Secret oder die Variable
ACTIONS_STEP_DEBUGauftruesetzt. Siehe Debug-Logging aktivieren. - Ergänze das oben beschriebene Speicher- und Festplatten-Logging und starte die Ausführung erneut.
- Führe denselben Job mit geringerer Parallelität aus. Läuft er durch, liegt die Ursache im Ressourcendruck.
Lösungen je nach Ergebnis
- Der Speicher ist das Problem und Feintuning reicht nicht aus: Verwende eine Maschine mit mehr RAM. Ein größerer GitHub-Runner funktioniert, ebenso ein Anbieter wie compiler.dev, dessen Standard-Linux-Maschine 8 vCPU / 16 GB hat und für jeden Job eine frische VM bereitstellt. Siehe Preise.
- Ein bestimmter Schritt bringt den Runner zum Absturz: Ändere ihn so, dass er nur seine eigenen Prozesse anspricht.
- Sporadisch ohne erkennbare Ursache: Starte die Ausführung erneut, und wenn es sich wiederholt, kontaktiere den GitHub-Support mit der URL des Laufs.
Ein Wiederholungs-Wrapper ist eine Notlösung für einen instabilen Schritt, keine Behebung der Ursache:
- uses: nick-fields/retry@v3
with:
timeout_minutes: 15
max_attempts: 2
command: npm test
So verhindern Sie den Fehler
- Setze Speichergrenzen für Tools (
NODE_OPTIONS,-Xmx,GRADLE_OPTS). - Begrenze die parallelen Worker auf die Anzahl der CPUs des Runners.
- Teile große Builds lieber in separate Jobs auf, statt einen sehr langen Job zu verwenden (siehe Zeitlimits und timeout-minutes).
- Protokolliere Speicher und Festplatte, damit du Trends erkennst, bevor es zum Fehler kommt.
- Führe niemals breite
pkill-Befehle aus.
FAQ
Ist "lost communication with the server" ein GitHub-Ausfall?
Manchmal, meist hat dein Job aber Speicher, Festplatte oder CPU erschöpft. Schlagen gleichzeitig andere Repositories fehl, prüfe die Statusseite.
Warum passiert das nur bei manchen Ausführungen?
Speicher- und Festplattennutzung hängen von der Reihenfolge der Tests, dem Cache-Zustand und der Eingabegröße ab. Ein Job nahe am Limit schlägt deshalb sporadisch fehl.
Zahle ich für den fehlgeschlagenen Lauf?
Die bis zum Fehler verbrauchten Minuten werden wie jede andere berechnet. Siehe GitHub Actions Preise.
Ist es dasselbe wie Exit-Code 137?
Die beiden Fehler haben meist dieselben Ursachen, meist Speichermangel, unterscheiden sich aber in dem, was Sie sehen. Exit 137 bedeutet, dass ein einzelner Prozess beendet wurde. Lost communication bedeutet, dass der gesamte Runner nicht mehr reagiert.
Verwandt
- Self-Hosted vs. GitHub-Hosted Runner: Kosten und RisikenVergleichen Sie GitHub-gehostete, selbst betriebene und Drittanbieter-Runner nach Kosten, Tempo, Sicherheit und Pflege, inkl. Break-even-Formel.
- Was ist ein selbst gehosteter Runner? (GitHub Actions)Ein Self-Hosted-Runner ist eine Maschine unter Ihrer Kontrolle, die GitHub-Actions-Jobs ausführt. Funktionsweise, Sicherheitsrisiken und Einsatzzeitpunkt im Überblick.
- 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.