Skip to main content

Installation – Panel

Das Pterodactyl Panel ist die zentrale Control-Plane der gesamten Plattform. Diese Installation beschreibt einen produktionsreifen Aufbau mit klarer Trennung, Sicherheits-Hardening und reproduzierbaren Schritten.

Diese Anleitung richtet sich explizit an Administratoren und Hosting-Betreiber, nicht an Endanwender.

1. Zielarchitektur & Grundannahmen

  • Eigenständige VM oder dedizierter Server
  • Kein Docker auf dem Panel
  • Kein Game-Server-Betrieb auf dem Panel
  • Öffentlich erreichbar via HTTPS

Empfohlene Basis:

  • Ubuntu Server LTS (minimal)
  • Statische IP
  • DNS: panel.domain.tld

2. Basissystem vorbereiten

2.1 System aktualisieren


apt update && apt upgrade -y

2.2 Basis-Tools installieren


apt install -y curl wget unzip tar ca-certificates gnupg lsb-release \
software-properties-common apt-transport-https

3. Datenbank installieren (MariaDB empfohlen)


apt install -y mariadb-server

3.1 Datenbank absichern


mysql_secure_installation

3.2 Datenbank & User anlegen


mysql -u root -p


CREATE DATABASE panel;
CREATE USER 'pterodactyl'@'localhost' IDENTIFIED BY 'STRONG_PASSWORD';
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'localhost';
FLUSH PRIVILEGES;
EXIT;

4. Redis installieren (Queue & Cache)


apt install -y redis-server
systemctl enable --now redis-server

Redis ist Pflicht – ohne Redis kein stabiler Queue-Betrieb.

5. PHP & Abhängigkeiten installieren

5.1 PHP Repository hinzufügen


add-apt-repository ppa:ondrej/php -y
apt update

5.2 PHP installieren


apt install -y php8.2 php8.2-cli php8.2-fpm php8.2-common php8.2-mysql \
php8.2-zip php8.2-gd php8.2-mbstring php8.2-curl php8.2-xml php8.2-bcmath

6. Composer installieren


curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer

7. Panel herunterladen & vorbereiten


mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl


curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz
tar -xzf panel.tar.gz
chmod -R 755 storage/* bootstrap/cache/

8. Panel konfigurieren

8.1 Environment vorbereiten


cp .env.example .env
composer install --no-dev --optimize-autoloader
php artisan key:generate --force

8.2 Basis-Setup


php artisan p:environment:setup
php artisan p:environment:database
php artisan p:environment:mail

9. Datenbank migrieren & Seeds


php artisan migrate --seed --force

10. Admin-Account anlegen


php artisan p:user:make

Dieser Account ist hochprivilegiert – sofort absichern.

11. Queue Worker (kritisch)

11.1 Systemd Service erstellen


nano /etc/systemd/system/pteroq.service


[Unit]
Description=Pterodactyl Queue Worker
After=redis-server.service

[Service]
User=www-data
Restart=always
ExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --sleep=3 --tries=3

[Install]
WantedBy=multi-user.target


systemctl daemon-reload
systemctl enable --now pteroq

12. Cronjob aktivieren


crontab -u www-data -e


* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1

13. NGINX installieren & konfigurieren


apt install -y nginx

Empfohlen: offizielles Pterodactyl NGINX Config-Template angepasst auf FQDN und PHP-Version.

14. SSL (Let's Encrypt)


apt install -y certbot python3-certbot-nginx
certbot --nginx -d panel.domain.tld

HTTP-Betrieb ist unzulässig.

15. Firewall & Hardening

  • Nur 80/443 öffentlich
  • SSH nur per Key
  • Fail2Ban empfohlen
  • Panel-Logs überwachen

16. Typische Installationsfehler

  • Queue nicht aktiv → Panel instabil
  • Falsche PHP-Version
  • Redis fehlt
  • Fehlende HTTPS-Erzwingung

17. Fazit

Das Panel ist kein Webprojekt, sondern ein sicherheitskritischer Management-Service.

Nur mit sauberer Installation, Queue-Betrieb, Redis und Hardening ist ein stabiler Plattformbetrieb möglich.

Venasty Systems betreibt Pterodactyl Panels ausschließlich nach diesem reproduzierbaren Standard.

Back to top