Pterodactyl: Behebung von Installationsfehlern bei SteamCMD

Sie starten die Installation eines Rust-, Valheim-, ARK- oder CS2-Servers über Pterodactyl, der Fortschrittsbalken läuft, doch dann bleibt der Server hängen. In den allermeisten Fällen liegt das Problem beim Schritt „SteamCMD“, bei dem die Spieledateien heruntergeladen werden. Im Folgenden erfahren Sie, wie Sie den Fehler interpretieren und von Fall zu Fall beheben können.

1. Was während der Installation geschieht

Wenn Sie einen Server erstellen, startet „Wings“, der auf dem Knoten installierte Dienst von Pterodactyl, einen temporären Container mit dem im Egg angegebenen Installations-Image. Bei Steam-Spielen handelt es sich fast immer um ein SteamCMD-Image. Dieser Container führt das Installationsskript des Eggs aus, lädt das Spiel herunter und wird anschließend beendet.

Sollte ein Schritt fehlschlagen, bleibt der Server während der Installation hängen. Gehen Sie in diesem Fall wie folgt vor: Lesen Sie das Installationsprotokoll und nicht die Konsole des Servers, da dieser noch gar nicht gestartet ist.

2. Das Bild „ghcr.io/parkervcp/steamcmd:debian“

Viele „Eggs“ beschreiben das Bild ghcr.io/parkervcp/steamcmd:debian. Das Projekt, das es pflegt, „yolks“, wurde inzwischen unter die Organisation „pelican-eggs“ verlagert, und dasselbe Bild wird veröffentlicht unter ghcr.io/pelican-eggs/steamcmd:debian.

Wir haben am 2. Oktober 2026 im Register nachgesehen: Beide Namen verweisen auf dasselbe Image mit demselben Fingerabdruck. Ein „Egg“, das noch den alten Namen verwendet, funktioniert daher weiterhin, und Sie können ohne Eile auf den neuen Namen umstellen, beispielsweise im Rahmen einer Aktualisierung Ihrer „Eggs“.

Sollte der Download des Images fehlschlagen, liegt das Problem also nicht am Namen: Überprüfen Sie stattdessen die Verbindung des Knotens zu ghcr.io, wie weiter unten beschrieben. Die anderen Varianten des Images (ubuntu, proton, dotnet, sniper) dienen spezifischen Anforderungen eines Spiels: Ändern Sie diese nur, wenn das Egg oder die Dokumentation des Spiels dies verlangt.

3. Die häufigsten SteamCMD-Fehlercodes

SteamCMD endet häufig mit einer Zeile wie folgender: Error! App 'XXX' state is 0x202 after update job. Der Hexadezimalcode gibt die Ursache an:

• 0x202 : Es ist nicht genügend Speicherplatz vorhanden, um das Spiel zu installieren oder zu aktualisieren.
• 0x402 : Die Steam-Update-Server sind nicht erreichbar, oder beim Knoten liegt ein Verbindungsproblem vor.
• 0x602 : Ein Netzwerkfehler hat den Download unterbrochen.
• No subscription : Das verwendete Konto verfügt nicht über das Spiel (siehe den folgenden Abschnitt).

Für 0x402 und 0x602, versuchen Sie zunächst, die Installation etwas später erneut zu starten: Ausfälle bei Steam kommen häufig vor und sind meist nur von kurzer Dauer. Sollte der Fehler bei jedem Versuch erneut auftreten, liegt das Problem auf Seiten des Knotens.

4. „No subscription“: Wenn eine anonyme Verbindung nicht ausreicht

Die meisten dedizierten Server werden über eine anonyme Verbindung zu Steam heruntergeladen. Bei einigen ist ein Konto erforderlich, in dem das Spiel vorhanden ist: SteamCMD verweigert in diesem Fall die Installation mit No subscription.

Geben Sie in diesem Fall die Steam-ID und das Steam-Passwort in die vom Egg vorgesehenen Variablen ein, in der Regel STEAM_USER und STEAM_PASS. Verwenden Sie hierfür ein eigens dafür eingerichtetes Konto anstelle Ihres persönlichen Kontos: Wenn Steam Guard aktiviert ist, erwartet SteamCMD einen Code, den eine automatische Installation nicht erhalten kann.

5. Festplatte und Grenzen des Installationscontainers

Ein Spiel mit einer Größe von mehreren Dutzend Gigabyte lässt sich nicht installieren, wenn die Festplattengrenze des Servers zu niedrig ist, selbst wenn auf dem Knoten noch Speicherplatz verfügbar ist. Überprüfen Sie die Größe des Spiels, bevor Sie den Server einrichten, und planen Sie einen Spielraum für Updates ein, bei denen manchmal umfangreiche temporäre Dateien heruntergeladen werden.

Auf Knotenebene legt Wings zudem Speicher- und Prozessorgrenzen für den Installationscontainer fest, die über installer_limits in /etc/pterodactyl/config.yml. Eine aufwendige Installation kann fehlschlagen, wenn diese Werte zu niedrig sind.

df -h /var/lib/pterodactyl

6. Netzwerk des Knotens: DNS und MTU

Dies ist die verwirrendste Ursache, und wir sind ihr auf einem unserer eigenen Knoten begegnet: Die Installation startet, bleibt dann aber ohne eindeutige Fehlermeldung hängen. Die Netzwerkschnittstelle des Knotens war auf eine MTU von 1450 eingestellt, während das Docker-Netzwerk von Pterodactyl eine MTU von 1500 verwendete. Große Pakete gingen unterwegs verloren, und die Downloads brachen ab.

Die Korrektur umfasst zwei Einstellungen: die MTU des Wings-Docker-Netzwerks an die der Schnittstelle anzupassen und anschließend eine Regel hinzuzufügen, die die Größe der TCP-Segmente anpasst.

ip link show eth0 | grep -o 'mtu [0-9]*'

# /etc/pterodactyl/config.yml
docker:
  network:
    network_mtu: 1450

iptables -t mangle -A FORWARD -p tcp --tcp-flags SYN,RST SYN -j TCPMSS --clamp-mss-to-pmtu

Bitte überprüfen Sie außerdem, ob der Knoten „ghcr.io“ und die Steam-Server auflöst: Die von den Containern verwendeten DNS-Server werden unter docker.network.dns, in derselben Datei.

7. ARM-Knoten: SteamCMD ist nicht dafür ausgelegt

Das SteamCMD-Image wird ausschließlich für die Architektur amd64 veröffentlicht: Sein Manifest enthält keine ARM-Version. Auf einem ARM-Knoten – sei es ein Raspberry Pi oder ein Ampere-Server – schlägt die Installation bereits beim Start des Containers fehl. Die einzige zuverlässige Lösung ist ein x86_64-Knoten.

8. Die Methode zur Diagnose

Anstatt die Installation willkürlich neu zu starten, befolgen Sie bitte folgende Reihenfolge:

• Lesen Sie das Ende des Installationsprotokolls durch und ermitteln Sie den Schritt, bei dem ein Fehler auftritt: Herunterladen des Images, SteamCMD oder das Egg-Skript.
• Wenn es sich um SteamCMD handelt, lesen Sie bitte den Fehlercode und schlagen Sie in Abschnitt 3 nach.
• Überprüfen Sie den Speicherplatz des Knotens und das Speicherplatzlimit des Servers.
• Überprüfen Sie die Verbindung des Knotens zu ghcr.io und zum Internet.
• Starten Sie das Panel nach Behebung der Ursache mithilfe der Neuinstallationsfunktion erneut.

tail -n 50 /var/log/pterodactyl/install/<identifiant-du-serveur>.log
curl -sI https://ghcr.io | head -n 1

Häufig gestellte Fragen

Weiterlesen

Pterodactyl: Mehrere Server pro Rechner

Docker-Container, Eggs, Verwaltung mehrerer Benutzer, Dimensionierung … Der Leitfaden zum Hosten und Weiterverkaufen mehrerer Spieleserver mit Pterodactyl.

Einen FiveM-Server auf einem VPS einrichten: Die umfassende Anleitung

Schritt-für-Schritt-Anleitung zur Installation eines FiveM-Servers auf einem Linux-VPS: Vorbereitung, Artefakte, Cfx.re-Schlüssel, server.cfg, txAdmin, MariaDB-Datenbank, systemd-Dienst, …

FiveM-Server mit Verzögerungen: Die Ursache finden

Fehlerdiagnose bei einem FiveM-Server mit Leistungseinbußen: resmon auslesen, die fehlerhafte Ressource identifizieren und feststellen, ob das Problem von den Skripten oder vom Server selbst verursacht wird.