Pterodactyl Panel: volledige installatie op je eigen VPS

We installeren Pterodactyl Panel, een webinterface voor het beheren van gameservers, op je VPS. Aan het eind draait het op het adres https://panel.example.cz met een Let's Encrypt-certificaat, een takenwachtrij, cron en je beheerdersaccount.

Hoe het werkt#

Pterodactyl bestaat uit twee delen. Het Panel is een webapplicatie (PHP, framework Laravel) waarin je gebruikers en servers aanmaakt en waarin spelers de console bedienen. Wings is de service die de gameservers op de server daadwerkelijk start, in Docker-containers. Het Panel en Wings kunnen op dezelfde VPS draaien. Deze handleiding installeert het Panel; Wings voeg je toe in de vervolghandleiding Pterodactyl Wings.

Het Panel heeft nog een aantal andere programma's nodig:

Het Panel zelf vraagt weinig. Draaien op dezelfde VPS ook gameservers, plan het RAM dan vooral op basis daarvan en tel er een reserve bij op voor het systeem, de database en het Panel (ruwweg 1–⁠2 GB).

Installatieplan#

Domein en DNS#

Het Panel heeft een eigen domein of subdomein nodig. Een certificaat voor HTTPS wordt uitgegeven voor een domein, niet voor een IP-adres.

1. Open in je klantaccount Mijn diensten, klik op de VPS en kopieer op het tabblad Netwerk het IPv4-⁠adres (en eventueel het IPv6-⁠adres).

2. Maak bij je DNS-provider een record van het type A aan voor panel.example.cz met als waarde het IPv4-⁠adres van de VPS (bijvoorbeeld 203.0.113.10).

3. Maak eventueel ook een AAAA-record aan met het IPv6-⁠adres van de VPS (bijvoorbeeld 2001:db8::10). De Nginx-configuratie hieronder luistert ook op IPv6.

4. Controleer op de VPS of het domein al goed verwijst:

   getent hosts panel.example.cz

   • getent hosts – vraagt de DNS van het systeem naar het adres van het domein en toont het.

   Je ziet een regel met het IP-adres van je VPS. Verschijnt er niets, wacht dan een paar minuten (afhankelijk van de TTL van het record) en probeer het opnieuw.

Firewall#

De browser maakt verbinding met het Panel op poort 443 (HTTPS). Poort 80 (HTTP) is nodig voor de domeincontrole bij het uitgeven van het certificaat en voor de doorverwijzing naar HTTPS.

• Firewall in je klantaccount: staat het inkomende verkeer in de modus Alles blokkeren behalve wat is toegestaan, voeg dan de regels Inkomend · Toestaan · TCP · poort 80,443 toe. De regel voor SSH (poort 22) moet blijven staan. Handleiding: Firewall in je klantaccount.

• UFW op de VPS: gebruik je UFW, sta de poorten dan ook daar toe:

  ufw allow 80/tcp
  ufw allow 443/tcp

  • ufw allow 80/tcp – staat inkomende TCP-verbindingen op poort 80 toe.
  • ufw allow 443/tcp – hetzelfde voor poort 443.

De poorten voor Wings (8080 en 2022) en voor gameservers open je pas in de handleiding Pterodactyl Wings.

Afhankelijkheden installeren#

Werk eerst het systeem bij, zodat je op een actuele basis installeert:

apt update && apt -y upgrade

• apt update – haalt de actuele pakketlijst op.
• apt -y upgrade – installeert de beschikbare updates; -y antwoordt “ja” op de bevestiging.

Installeer daarna de afhankelijkheden. De stappen verschillen per systeem: Ubuntu 24.04 heeft PHP 8.3 rechtstreeks in de repository, Debian 13 heeft in de standaardrepository PHP 8.4, dat het Panel niet ondersteunt (het huidige Panel vereist PHP 8.2 of 8.3). Op Debian voeg je daarom de repository packages.sury.org toe, die ook de officiële documentatie van Pterodactyl aanbeveelt.

Wat het installatiecommando bevat:

Controleer of je de juiste PHP-versie hebt:

php -v

PHP 8.3.x (cli) …

Op de eerste regel moet PHP 8.3 staan. Zie je PHP 8.4, kijk dan in het onderdeel Als iets niet werkt.

Controleer of de services draaien:

systemctl is-active mariadb redis-server nginx php8.3-fpm

• systemctl is-active – toont de status van elke genoemde service.

Je ziet vier keer active. Is er één inactive, start die dan en schakel hem in bij het opstarten met het commando systemctl enable --now <SERVICE_NAME>, bijvoorbeeld systemctl enable --now redis-server.

Composer#

Composer downloadt de PHP-bibliotheken van het Panel. Installeer het met de officiële installer:

curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

• curl -sS https://getcomposer.org/installer – downloadt het installatiescript van Composer.
• | php -- – geeft het script door aan PHP om het uit te voeren; -- scheidt de parameters van PHP van die van de installer.
• --install-dir=/usr/local/bin – waar Composer wordt geïnstalleerd (een map waarin het systeem naar programma's zoekt).
• --filename=composer – de naam van het programma, zodat je het daarna start met het commando composer.

Controle: composer --version toont Composer version 2.…. Als root zie je ook de waarschuwing Do not run Composer as root/super user! en mogelijk de vraag Continue as root/super user [yes]?. Bevestig die met de toets Enter. Bij de installatie van het Panel hieronder onderdrukt de variabele COMPOSER_ALLOW_SUPERUSER=1 de waarschuwing.

Het Panel downloaden#

1. Maak een map voor het Panel aan en ga ernaartoe:

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

   • mkdir -p – maakt de map aan (inclusief de bovenliggende mappen); bestaat hij al, dan volgt er geen foutmelding.
   • cd – gaat naar de map. Voer alle volgende commando's met php artisan daarin uit.

2. Download de nieuwste versie van het Panel en pak die uit:

   curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz
   tar -xzvf panel.tar.gz

   • curl -Lo panel.tar.gz … – downloadt het archief van de nieuwste release van GitHub en slaat het op als panel.tar.gz.
   • tar -xzvf – pakt het archief uit (x uitpakken, z gzip-formaat, v bestanden tonen, f uit een bestand).

3. Stel de rechten in van de mappen waarin het Panel schrijft:

   chmod -R 755 storage/* bootstrap/cache/

   • chmod -R 755 – de eigenaar mag lezen, schrijven en de mappen openen, anderen mogen alleen lezen en de mappen openen. -R geldt voor de hele inhoud.
   • storage/ – logs, cache en geüploade bestanden; bootstrap/cache/ – de gecompileerde configuratie.

Een database voor het Panel#

Het Panel heeft een eigen database en een eigen gebruiker nodig. De databasegebruiker root verbieden de makers van Pterodactyl uitdrukkelijk voor het Panel: als iemand het Panel zou kraken, kreeg hij toegang tot alle databases op de VPS.

1. Genereer een sterk wachtwoord voor de databasegebruiker, bijvoorbeeld met de wachtwoordgenerator. Gebruik alleen letters en cijfers (minstens 24 tekens), zodat je je niet druk hoeft te maken over speciale tekens in SQL en in .env. Bewaar het wachtwoord, je moet het zo meteen opnieuw invullen.

2. Log in op MariaDB als beheerder:

   mariadb

   • mariadb – de client van de database. De gebruiker root van het systeem logt op zowel Ubuntu als Debian zonder wachtwoord in op MariaDB (via verificatie met de unix socket). Je ziet de prompt MariaDB [(none)]>.

3. Maak de gebruiker en de database aan. Vervang <PANEL_DB_PASSWORD> door het wachtwoord uit stap 1 (laat de enkele aanhalingstekens rond het wachtwoord staan):

   CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY '<PANEL_DB_PASSWORD>';
   CREATE DATABASE panel;
   GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1';
   exit

De omgeving configureren (.env)#

De instellingen van het Panel staan in het bestand /var/www/pterodactyl/.env. Je maakt het aan op basis van een voorbeeldbestand, installeert de bibliotheken en genereert de versleutelingssleutel.

1. Kopieer het voorbeeldbestand:

   cp .env.example .env

2. Installeer de PHP-bibliotheken van het Panel:

   COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader

   • COMPOSER_ALLOW_SUPERUSER=1 – staat toe dat Composer zonder vraag als root wordt uitgevoerd.
   • composer install – downloadt de bibliotheken in precies de versies die het Panel voorschrijft (het bestand composer.lock).
   • --no-dev – slaat hulpmiddelen voor ontwikkelaars over, die heb je op een productieserver niet nodig.
   • --optimize-autoloader – zorgt ervoor dat PHP-klassen sneller worden geladen.

   De installatie duurt enkele minuten en eindigt zonder foutmeldingen (een gele waarschuwing over verouderde pakketten is geen probleem).

3. Genereer de versleutelingssleutel:

   php artisan key:generate --force

   • php artisan – het hulpprogramma van het Panel voor beheer vanaf de opdrachtregel.
   • key:generate – maakt een willekeurige sleutel APP_KEY aan en schrijft die naar .env.
   • --force – voert het commando uit zonder bevestiging (het Panel draait in productiemodus, waarin het anders om bevestiging vraagt).

4. Toon de sleutel en bewaar de hele regel buiten de server (in een wachtwoordmanager of in een versleuteld bestand op je computer):

   grep APP_KEY /var/www/pterodactyl/.env

   APP_KEY=base64:…

De wizard p:environment:setup#

De basisinstellingen regelt een wizard. Start hem:

php artisan p:environment:setup

Hij vraagt achtereenvolgens het volgende (de standaardwaarde staat tussen vierkante haken, je bevestigt die met de toets Enter):

Vul je een adres in dat begint met https://, dan schakelt de wizard zelf veilige cookies in (SESSION_SECURE_COOKIE=true).

De wizard p:environment:database#

php artisan p:environment:database

De wizard probeert meteen verbinding te maken. Kloppen de gegevens niet, dan toont hij Unable to connect to the MySQL server…, slaat hij niets op en vraagt hij of je het opnieuw wilt proberen.

De wizard p:environment:mail#

Het Panel verstuurt e-mails (uitnodigingen voor nieuwe gebruikers, wachtwoordherstel). Zonder ingestelde e-mail werkt het Panel wel, alleen worden deze e-mails niet verstuurd. Je kunt dit ook later instellen, met hetzelfde commando:

php artisan p:environment:mail

Belangrijke sleutels in .env#

De wizards schrijven deze waarden naar .env. Je kunt het bestand ook handmatig bewerken (nano /var/www/pterodactyl/.env); voer na een handmatige wijziging php artisan config:clear uit.

Databasetabellen en de eerste beheerder#

1. Maak de tabellen aan en laad de standaardgegevens:

   php artisan migrate --seed --force

   • migrate – maakt in de database panel alle tabellen aan.
   • --seed – vult ze met standaardgegevens, waaronder gamesjablonen (Minecraft, Rust en andere).
   • --force – voert het commando in productiemodus uit zonder bevestiging.

   Het commando kan enkele minuten duren. Onderbreek het niet, anders blijft de database half aangemaakt achter.

2. Maak het beheerdersaccount aan:

   php artisan p:user:make

Aan het eind zie je een tabel met de gegevens van het account en de regel Admin | Yes.

Bestandsrechten#

De bestanden van het Panel zijn nu van de gebruiker root. De webserver draait als de gebruiker www-data en moet in de mappen storage en bootstrap/cache kunnen schrijven:

chown -R www-data:www-data /var/www/pterodactyl/*

• chown -R – wijzigt de eigenaar van de bestanden en van de hele inhoud van de mappen.
• www-data:www-data – de gebruiker en de groep waaronder Nginx en PHP-FPM op Ubuntu en Debian draaien.

Cron en de takenwachtrij#

Cron#

Cron start de planner van het Panel elke minuut (oude inlogsessies opruimen, geplande taken van servers).

1. Open de crontab van de gebruiker root:

   crontab -e

   Bij de eerste keer vraagt het om een editor. Kies nano (typ het nummer ervan en druk op Enter). Meldt het systeem crontab: command not found, dan ontbreekt cron. Installeer het met het commando apt -y install cron en herhaal de stap.

2. Plak aan het eind van het bestand deze regel:

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

3. Sla op (Ctrl+O, Enter) en sluit de editor (Ctrl+X). Je ziet crontab: installing new crontab.

De wachtrijservice pteroq#

De wachtrij verwerkt werk op de achtergrond: het verzenden van e-mails en de taken die gebruikers bij hun servers inplannen (het onderdeel Schedules, bijvoorbeeld een nachtelijke herstart of back-up). Zonder de wachtrij worden e-mails niet verstuurd en worden geplande taken niet uitgevoerd.

1. Maak het servicebestand aan:

   nano /etc/systemd/system/pteroq.service

2. Plak de inhoud:

   # Pterodactyl Queue Worker File
   [Unit]
   Description=Pterodactyl Queue Worker
   After=redis-server.service
   
   [Service]
   User=www-data
   Group=www-data
   Restart=always
   ExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
   StartLimitInterval=180
   StartLimitBurst=30
   RestartSec=5s
   
   [Install]
   WantedBy=multi-user.target

3. Sla op en sluit de editor.

4. Schakel Redis en de wachtrij in bij het opstarten en start ze meteen:

   systemctl enable --now redis-server
   systemctl enable --now pteroq.service

   • enable – schakelt automatisch starten na een herstart van de VPS in.
   • --now – start de service bovendien meteen.

5. Controleer de status:

   systemctl status pteroq

   Je ziet Active: active (running). Sluit de uitvoer met de toets q.

Het Let's Encrypt-certificaat#

De Nginx-configuratie hieronder verwijst naar de bestanden van het certificaat. Nginx start daarmee niet zolang het certificaat niet bestaat; daarom vraag je het certificaat als eerste aan.

1. Installeer Certbot en de bijbehorende plugin voor Nginx:

   apt -y install certbot python3-certbot-nginx

   • certbot – het programma dat Let's Encrypt-certificaten aanvraagt en verlengt.
   • python3-certbot-nginx – een plugin die het domein controleert via de draaiende Nginx, zonder die uit te schakelen.

2. Vraag het certificaat aan. Vervang panel.example.cz door je eigen domein:

   certbot certonly --nginx -d panel.example.cz

   • certonly – vraagt alleen het certificaat aan en slaat het op; de configuratie van Nginx past het niet aan (die schrijf je zelf).
   • --nginx – de domeincontrole verloopt via Nginx op poort 80.
   • -d panel.example.cz – het domein waarvoor je het certificaat wilt.

3. Beantwoord bij de eerste keer de vragen:

   • E-mailadres (Enter email address…) – vul je e-mailadres in. Let's Encrypt stuurt daar belangrijke meldingen over het account naartoe. Waarschuwingen over het verlopen van een certificaat stuurt het sinds 2025 niet meer; de verlenging wordt daarom automatisch bewaakt (zie stap 5).
   • Servicevoorwaarden (Please read the Terms of Service… Do you agree?) – antwoord Y, zonder akkoord krijg je geen certificaat.
   • Je e-mailadres delen met de EFF (Would you be willing… to share your email address with the Electronic Frontier Foundation…) – naar eigen keuze, het heeft geen invloed op de uitgifte van het certificaat.

   Aan het eind zie je Successfully received certificate. en de paden naar de bestanden:

   Certificate is saved at: /etc/letsencrypt/live/panel.example.cz/fullchain.pem
   Key is saved at:         /etc/letsencrypt/live/panel.example.cz/privkey.pem

4. Zorg ervoor dat Nginx na elke verlenging van het certificaat het nieuwe laadt. Maak een zogeheten deploy hook aan (een script dat Certbot na een geslaagde verlenging uitvoert):

   cat > /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh <<'EOF'
   #!/bin/sh
   systemctl reload nginx
   EOF
   chmod 755 /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh

   • cat > … <<'EOF' … EOF – schrijft de regels tussen <<'EOF' en EOF naar het bestand.
   • systemctl reload nginx – laadt de nieuwe configuratie en de certificaten zonder verbindingen te verbreken.
   • chmod 755 – maakt het script uitvoerbaar; Certbot voert in de map renewal-hooks/deploy alleen uitvoerbare bestanden uit.

5. Controleer of de automatische verlenging werkt. Het pakket van Certbot bevat op zowel Ubuntu als Debian een timer die de verlenging twee keer per dag probeert:

   systemctl list-timers | grep certbot
   certbot renew --dry-run

   • systemctl list-timers – toont de geplande timers; daartussen hoort certbot.timer te staan.
   • certbot renew --dry-run – test de verlenging tegen de testserver van Let's Encrypt; het echte certificaat verandert niet.

   De test eindigt met de melding Congratulations, all simulated renewals succeeded.

Het certificaat is 90 dagen geldig (stand oktober 2026; Let's Encrypt verkort de geldigheid geleidelijk). Certbot verlengt het zelf wanneer er nog ongeveer een derde van de geldigheid over is.

Nginx#

1. Schakel de standaardwebsite van Nginx uit:

   rm /etc/nginx/sites-enabled/default

   • Verwijdert alleen de link in sites-enabled, het bestand zelf in sites-available blijft staan. Anders zou de standaardwebsite poort 80 bedienen in plaats van het Panel.

2. Maak de configuratie van het Panel aan:

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

3. Plak de inhoud en vervang alle vier de vermeldingen van panel.example.cz door je eigen domein:

   server {
       listen 80;
       listen [::]:80;
       server_name panel.example.cz;
       return 301 https://$server_name$request_uri;
   }
   
   server {
       listen 443 ssl http2;
       listen [::]:443 ssl http2;
       server_name panel.example.cz;
       server_tokens off;
   
       root /var/www/pterodactyl/public;
       index index.php;
   
       access_log /var/log/nginx/pterodactyl.app-access.log;
       error_log  /var/log/nginx/pterodactyl.app-error.log error;
   
       # grotere uploads en een langere looptijd van scripts
       client_max_body_size 100m;
       client_body_timeout 120s;
   
       sendfile off;
   
       ssl_certificate /etc/letsencrypt/live/panel.example.cz/fullchain.pem;
       ssl_certificate_key /etc/letsencrypt/live/panel.example.cz/privkey.pem;
       ssl_session_cache shared:SSL:10m;
       ssl_protocols TLSv1.2 TLSv1.3;
       ssl_ciphers "ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384";
       ssl_prefer_server_ciphers on;
   
       add_header X-Content-Type-Options nosniff;
       add_header X-XSS-Protection "1; mode=block";
       add_header X-Robots-Tag none;
       add_header Content-Security-Policy "frame-ancestors 'self'";
       add_header X-Frame-Options DENY;
       add_header Referrer-Policy same-origin;
   
       location / {
           try_files $uri $uri/ /index.php?$query_string;
       }
   
       location ~ \.php$ {
           fastcgi_split_path_info ^(.+\.php)(/.+)$;
           fastcgi_pass unix:/run/php/php8.3-fpm.sock;
           fastcgi_index index.php;
           include fastcgi_params;
           fastcgi_param PHP_VALUE "upload_max_filesize = 100M \n post_max_size=100M";
           fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
           fastcgi_param HTTP_PROXY "";
           fastcgi_intercept_errors off;
           fastcgi_buffer_size 16k;
           fastcgi_buffers 4 16k;
           fastcgi_connect_timeout 300;
           fastcgi_send_timeout 300;
           fastcgi_read_timeout 300;
       }
   
       location ~ /\.ht {
           deny all;
       }
   }

De configuratie is gebaseerd op de officiële documentatie van Pterodactyl. We hebben het luisteren op IPv6 (listen [::]:…) en het verbergen van de Nginx-versie toegevoegd. Wat de afzonderlijke onderdelen doen:

4. Schakel de configuratie in, test die en herstart Nginx:

   ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/pterodactyl.conf
   nginx -t
   systemctl restart nginx

   • ln -s – maakt in sites-enabled een link naar het bestand aan; Nginx laadt alleen configuraties in sites-enabled.
   • nginx -t – controleert de syntaxis. De uitvoer moet eindigen met de regel test is successful. Zo niet, herstart Nginx dan niet en verbeter de regel die de fout noemt.
   • systemctl restart nginx – laadt de nieuwe configuratie.

De eerste keer inloggen#

1. Open https://panel.example.cz in je browser. Je ziet de inlogpagina van het Panel met een slotje (geldig certificaat) in de adresbalk.
2. Log in met de naam of het e-mailadres en het wachtwoord van de beheerder.
3. Klik rechtsboven op het tandwielpictogram (beheergedeelte). Stel in het onderdeel Settings de naam van het Panel in (Company Name).
4. Schakel tweestapsverificatie in: klik rechtsboven op je account, open Account en scan in het onderdeel voor tweestapsverificatie de QR-code met een app (bijvoorbeeld Google Authenticator of Aegis). Het beheerdersaccount bestuurt alle servers, bescherm het daarom met meer dan alleen een wachtwoord.

Controle#

Controleer de hele installatie:

systemctl is-active nginx php8.3-fpm mariadb redis-server pteroq
curl -sI https://panel.example.cz | head -n 1

• Het eerste commando moet vijf keer active tonen.
• curl -sI haalt alleen de headers van het antwoord op; de eerste regel is HTTP/2 302 (doorverwijzing naar de inlogpagina) of HTTP/2 200.

Het Panel is klaar. De volgende stap is een node met de service Wings toevoegen, waarop de gameservers gaan draaien: Pterodactyl Wings.

Het Panel achter Cloudflare#

Je kunt het Panel achter de proxy van Cloudflare zetten (oranje wolkje). Dat geldt alleen voor het Panel, niet voor Wings (zie Pterodactyl Wings).

1. Stel in Cloudflare de SSL/TLS-modus in op Full (strict). Cloudflare maakt dan via HTTPS verbinding met de VPS en controleert je Let's Encrypt-certificaat.

2. Zet het record panel.example.cz op Proxied.

3. Voeg in .env op één regel de IP-bereiken van Cloudflare toe. Achter de proxy komen alle verzoeken bij het Panel binnen vanaf adressen van Cloudflare. Het Panel neemt het echte IP-adres van de bezoeker dan over uit de header X-Forwarded-For, maar alleen van adressen die het vertrouwt. Zonder deze regel zou het Panel bij alle gebruikers alleen de adressen van Cloudflare zien, zowel in de activiteitenlogs als in de bescherming tegen het raden van wachtwoorden, die de pogingen per IP-adres telt. De lijst hieronder geeft de stand van 1 oktober 2026 weer; de actuele lijst vind je op de pagina cloudflare.com/ips (opent in een nieuw venster):

   TRUSTED_PROXIES=173.245.48.0/20,103.21.244.0/22,103.22.200.0/22,103.31.4.0/22,141.101.64.0/18,108.162.192.0/18,190.93.240.0/20,188.114.96.0/20,197.234.240.0/22,198.41.128.0/17,162.158.0.0/15,104.16.0.0/13,104.24.0.0/14,172.64.0.0/13,131.0.72.0/22,2400:cb00::/32,2606:4700::/32,2803:f800::/32,2405:b500::/32,2405:8100::/32,2a06:98c0::/29,2c0f:f248::/32

   • TRUSTED_PROXIES – een lijst met adressen en bereiken (gescheiden door komma's, zonder spaties) waarvan het Panel de headers X-Forwarded-* met het echte IP-adres van de bezoeker en het protocol accepteert. Van andere adressen negeert het deze headers, zodat niemand ze kan vervalsen.

4. Laad de nieuwe configuratie: cd /var/www/pterodactyl && php artisan config:clear.

Het Panel updaten#

Nieuwe versies van het Panel verhelpen fouten en beveiligingslekken; update daarom regelmatig. Lees vóór het updaten de release-opmerkingen op GitHub en controleer welke PHP-versie de nieuwe versie vereist (php -v).

• mariadb-dump --single-transaction panel – exporteert de database panel naar een SQL-bestand zonder tabellen te vergrendelen.
• $(date +%F) – zet de datum van vandaag (bijvoorbeeld 2026-10-01) in de bestandsnaam.

Voer daarna de update uit:

cd /var/www/pterodactyl
php artisan down
curl -L https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz | tar -xzv
chmod -R 755 storage/* bootstrap/cache
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
php artisan view:clear
php artisan config:clear
php artisan migrate --seed --force
chown -R www-data:www-data /var/www/pterodactyl/*
php artisan queue:restart
php artisan up

Update na het Panel ook Wings; de stappen staan in de handleiding Pterodactyl Wings. De versies van het Panel en Wings horen gelijk op te lopen: gebruik van beide de nieuwste release.

Back-ups van het Panel#

Om het Panel te herstellen heb je twee dingen nodig: de database panel en het bestand .env (vooral APP_KEY). De gegevens van gameservers staan op de node met Wings, niet in het Panel; maak daar apart een back-up van. Hoe je back-ups automatiseert en buiten de server bewaart, staat in de handleiding Back-ups op een VPS.

Als iets niet werkt#

502 Bad Gateway#

Nginx heeft PHP-FPM niet bereikt. Controleer of PHP-FPM draait en of het pad naar de socket klopt:

systemctl status php8.3-fpm
ls /run/php/

In de uitvoer van ls moet php8.3-fpm.sock staan en hetzelfde pad moet in de directive fastcgi_pass staan. Draait de service niet, start hem dan: systemctl enable --now php8.3-fpm.

Fout 500 of een lege pagina#

Kijk in de log van het Panel:

tail -n 100 /var/www/pterodactyl/storage/logs/laravel-$(date +%F).log

• tail -n 100 – toont de laatste 100 regels van de log van vandaag.

Zoek naar een regel met een datum en het woord ERROR. De meest voorkomende oorzaken:

• Permission denied – een verkeerde eigenaar van de bestanden. Voer chown -R www-data:www-data /var/www/pterodactyl/* opnieuw uit.
• No application encryption key has been specified. – APP_KEY ontbreekt. Voer bij de eerste installatie php artisan key:generate --force uit. Bevat het Panel al gegevens, zet dan de oorspronkelijke sleutel uit je back-up terug.
• SQLSTATE[HY000] [1045] Access denied – het wachtwoord of de gebruiker van de database in .env klopt niet.

The MAC is invalid#

De database is versleuteld met een andere APP_KEY dan de sleutel die nu in .env staat. Meestal gebeurt dit na het terugzetten van de database op een nieuwe installatie. De enige oplossing is de oorspronkelijke APP_KEY terugzetten in .env. Zonder die sleutel zijn de versleutelde gegevens niet te herstellen.

E-mails worden niet verstuurd#

Meestal draait de wachtrij niet. Controleer de service en de bijbehorende log:

systemctl status pteroq
journalctl -u pteroq -n 50

• journalctl -u pteroq -n 50 – de laatste 50 regels van de log van de service.

Controleer ook of Redis draait (systemctl status redis-server). Voer na het oplossen systemctl restart pteroq uit. Draait de wachtrij wel, controleer dan de e-mailinstellingen (php artisan p:environment:mail) en de fouten in de log van het Panel (hoofdstuk Fout 500).

Een server blijft hangen op de installatie#

De installatie van een server voert Wings uit, niet het Panel. De stappen staan in de handleiding Pterodactyl Wings in het onderdeel “Als iets niet werkt” (meestal een niet-werkende DNS in de containers of een onbereikbare node).

Geplande taken van servers worden niet gestart#

Controleer of de wachtrij draait (systemctl status pteroq), de regel in cron (crontab -l) en de tijdzones: het systeem (timedatectl), het Panel (APP_TIMEZONE in .env). Het helpt ook om de cache van de planner te wissen:

php /var/www/pterodactyl/artisan schedule:clear-cache
systemctl restart pteroq

Nginx start niet: cannot load certificate#

Het certificaat voor het domein in de configuratie bestaat niet: je hebt het niet aangevraagd, of het domein in server_name en in het pad /etc/letsencrypt/live/… wijkt af van het domein waarvoor het is uitgegeven. Een lijst met certificaten krijg je met certbot certificates.

Certbot: Timeout during connect (likely firewall problem)#

Let's Encrypt heeft poort 80 van je VPS niet bereikt. Controleer of het A-record van het domein naar het IPv4-⁠adres van de VPS verwijst, of poort 80 is toegestaan in zowel de firewall van je klantaccount als UFW en of Nginx draait. Heeft het domein een AAAA-record, dan moet dat naar het IPv6-⁠adres van deze VPS verwijzen; Let's Encrypt probeert ook IPv6.

Composer of artisan meldt een verkeerde PHP-versie#

De melding bevat bijvoorbeeld requires php ^8.2 || ^8.3 but your php version (8.4…) does not satisfy that requirement. Het commando php start een andere versie dan 8.3, meestal op Debian 13 na de installatie van het standaardpakket php. Stel PHP 8.3 in als standaard:

update-alternatives --set php /usr/bin/php8.3
php -v

• update-alternatives --set php … – bepaalt welke versie het commando php start.

Bestaat /usr/bin/php8.3 niet, dan is PHP 8.3 niet geïnstalleerd. Ga terug naar het hoofdstuk Afhankelijkheden installeren.

De pagina blijft achter Cloudflare doorverwijzen (ERR_TOO_MANY_REDIRECTS)#

In Cloudflare staat de modus Flexible ingesteld. Zet die op Full (strict) en controleer ook TRUSTED_PROXIES volgens Het Panel achter Cloudflare.

Achter Cloudflare werkt de console van servers niet#

Het domein van de node loopt via de proxy van Cloudflare (oranje wolkje). Meestal gebeurt dat als de node hetzelfde domein gebruikt als het Panel. Zet het domein van de node op DNS only, of geef de node een eigen subdomein.

Meer bronnen#

• Pterodactyl: Getting Started (opent in een nieuw venster)
• Pterodactyl: Webserver Configuration (opent in een nieuw venster)
• Pterodactyl: Updating the Panel (opent in een nieuw venster)
• Pterodactyl: Additional Configuration (opent in een nieuw venster)
• Pterodactyl: Troubleshooting (opent in een nieuw venster)
• Certbot: User Guide (opent in een nieuw venster)