🇩🇪 DE 🇬🇧 EN

Pterodactyl installieren – Panel & Wings Schritt für Schritt

Kurzantwort: Pterodactyl installierst du am schnellsten mit dem Community-Installer auf Ubuntu: bash <(curl -s https://pterodactyl-installer.se), Option 2 (Panel + Wings). Danach Node, Allocations und Wings-Token einrichten.

Diese Anleitung zeigt dir Schritt für Schritt, wie du das Pterodactyl Panel und Wings auf deinem Server installierst. Pterodactyl ist ein kostenloses, Open-Source-Game-Server-Verwaltungspanel, das auf Docker-Containern basiert. Am Ende hast du eine lauffähige Umgebung, in der du Game-Server mit wenigen Klicks erstellen und verwalten kannst.

Hinweis: Ausführliche Unterseiten zu Konfiguration, Fehlerbehebung und Optimierung findest du in der linken Navigation.

Voraussetzungen

Schritt 1: Grundlegende Server-Vorbereitung

Verbinde dich per SSH mit deinem Server:

ssh root@deine-server-ip

Aktualisiere das System:

apt update && apt upgrade -y

Schritt 2: Pterodactyl Panel installieren

Pterodactyl bietet ein offizielles Installationsskript, das den gesamten Prozess automatisiert. Führe folgenden Befehl aus:

bash <(curl -s https://pterodactyl-installer.se)

Das Skript startet und führt dich durch die Installation. Wähle im ersten Menü Option 2 – "Install Panel and Wings" um beides gleichzeitig zu installieren.

Schritt 3: Installationsfragen beantworten

Während der Installation wirst du nach verschiedenen Einstellungen gefragt. Hier eine Übersicht mit Empfehlungen:

Einstellung Empfehlung
Datenbank-Name Enter drücken (Standard: panel)
Datenbank-Benutzername Enter drücken (Standard: pterodactyl)
Datenbank-Passwort Sicheres Passwort vergeben und notieren
Zeitzone z.B. Europe/Berlin
E-Mail für Let's Encrypt Deine echte E-Mail-Adresse
Admin-E-Mail Deine E-Mail für den Panel-Login
Admin-Benutzername z.B. admin
Admin-Passwort Sicheres Passwort – damit loggst du dich später ein
FQDN (Domain) Deine Domain oder Server-IP
Firewall konfigurieren Ja (y)
Let's Encrypt SSL Ja – nur mit Domain, nicht mit IP-Adresse

Schritt 4: Installation abschließen

Das Skript installiert nun automatisch:

Die Installation dauert etwa 10-15 Minuten. Am Ende erhältst du eine Zusammenfassung mit allen Zugangsdaten.

Schritt 5: Panel im Browser öffnen

Rufe deine Domain oder Server-IP im Browser auf. Du solltest die Pterodactyl-Login-Seite sehen:

https://deine-domain.de  # oder http://deine-server-ip

Melde dich mit den Admin-Zugangsdaten an, die du während der Installation vergeben hast.

Schritt 6: Node erstellen – Wings verbinden

Pterodactyl Admin – Node erstellen, Allocations und Wings Token
Nodes → Create → Allocations (Ports) → Configuration → Generate Token → Wings starten.

Damit du Game-Server hosten kannst, musst du einen Node erstellen und mit Wings verbinden:

  1. Klicke im Admin-Bereich links auf "Locations"
  2. Erstelle einen neuen Standort (z.B. "Deutschland") über "Create New"
  3. Klicke links auf "Nodes"
  4. Klicke auf "Create New"
  5. Fülle die Felder aus:
    • Name: z.B. "Node-1"
    • Location: Wähle deinen erstellten Standort
    • FQDN: Deine Panel-Domain oder Server-IP
    • Total Memory: Dein gesamter RAM in MiB (z.B. 16384 für 16 GB)
    • Total Disk Space: Dein gesamter Speicher in MiB (z.B. 102400 für 100 GB)
  6. Klicke auf "Create Node"

Schritt 7: Node-Allocations einrichten

Pterodactyl Allocations – Ports für Gameserver einrichten
Tab Allocation: IP + Port-Bereich (z.B. 25565–25665 für Minecraft) eintragen.

Allocations sind IP-Adressen und Ports, die deine Game-Server nutzen:

  1. Klicke auf deinen erstellten Node
  2. Gehe zum Tab "Allocations"
  3. Gib deine Server-IP ein und einen Port-Bereich (z.B. 25565-25665 für Minecraft)
  4. Klicke auf "Submit"

Schritt 8: Wings mit dem Panel verbinden

  1. Klicke auf den Tab "Configuration" in deinem Node
  2. Klicke auf "Generate Token"
  3. Kopiere den angezeigten Befehl und führe ihn in deiner SSH-Konsole aus
  4. Starte Wings mit: 
    sudo systemctl enable --now wings

Wechsle zurück zum Panel. Der Node sollte nun als online (grünes Herz) angezeigt werden.

Schritt 9: Ersten Game-Server erstellen

  1. Klicke links auf "Servers"
  2. Klicke auf "Create New"
  3. Wähle deinen Node aus
  4. Wähle ein Game (z.B. Minecraft) und konfiguriere Speicher, CPU und Ports
  5. Klicke auf "Create Server"

Dein Server wird erstellt und kann über die Server-Verwaltung gestartet werden.

Häufige Probleme und Lösungen

nginx startet nicht: Falls die Installation mit einem nginx-Fehler endet, bearbeite die Konfiguration:

nano /etc/nginx/sites-enabled/pterodactyl.conf

Ersetze fastcgi_pass unix:/run/php/phpX.X-fpm.sock; durch:

fastcgi_pass 127.0.0.1:9000;

Dann nginx neustarten: systemctl restart nginx

Node bleibt offline: Prüfe ob Wings läuft:

sudo systemctl status wings

Falls nicht, starte Wings im Debug-Modus:

sudo wings --debug

Fehlermeldungen helfen bei der Ursachensuche.

"Pool overlaps" Fehler: Docker-Netzwerke überlappen sich. Bearbeite die Wings-Konfiguration:

nano /etc/pterodactyl/config.yml

Ändere das Subnetz unter docker.network.interfaces.v4.subnet auf einen freien Bereich, z.B. 172.19.0.0/24 statt 172.18.0.0/16.

Nützliche Befehle

# Alle Benutzer auflisten
php artisan p:user:list

# Neuen Admin-Benutzer erstellen
php artisan p:user:make

# Benutzer löschen
php artisan p:user:delete

Diese Befehle müssen im Panel-Verzeichnis /var/www/pterodactyl ausgeführt werden.

Schnell-Checkliste

  1. Ubuntu 22.04 oder 24.04 Server mit root-Zugriff
  2. Installationsskript ausführen: bash <(curl -s https://pterodactyl-installer.se)
  3. Option 2 (Panel + Wings) wählen
  4. Alle Installationsfragen beantworten
  5. Im Browser einloggen
  6. Location und Node erstellen
  7. Allocations für Ports einrichten
  8. Wings-Token generieren und verbinden
  9. Ersten Game-Server erstellen

Ausführliche Anleitungen zu Eggs, Server-Konfiguration und Fehlerbehebung findest du in den Artikeln der linken Navigation.

Weiterführende Guides