Je bepaalt welke diensten wij mogen inschakelen voor analyse, personalisatie en externe inhoud.
We gebruiken cookies en vergelijkbare technologieën op onze website om inhoud te personaliseren, externe media te integreren en het gebruik van afzonderlijke onderdelen beter te begrijpen.
Noodzakelijke cookies
Deze vermeldingen waarborgen basisfuncties zoals beveiliging, stabiliteit en formulierverwerking.
Optionele secties
AnalysesMarketingPersonalisatieExterne media
Gegevensverwerking kan plaatsvinden met je toestemming of op basis van gerechtvaardigde belangen. In de cookie-instellingen kun je elke optionele categorie weigeren of afzonderlijk toestaan.
Sommige diensten verwerken persoonsgegevens in derde landen. Met je toestemming accepteer je ook deze doorgifte. Meer informatie vind je in onze privacyverklaring.
Je kunt je selectie later op elk moment opnieuw openen en aanpassen. · 1.0.2
Pterodactyl installeren op een Linux-server – host je eigen game serverpaneel
Ontdek hoe je Pterodactyl Panel en Wings op je Linux-server installeert en je eigen game servers eenvoudig via een webinterface beheert → Ontdek het nu
10 november 202613 min leestijd1 Weergaven0 nuttig
Inleiding
Pterodactyl is een gratis, open-sourcepaneel waarmee je game servers zoals Minecraft, Rust, ARK of CS2 beheert via een webinterface. Elke game server draait in een eigen Docker-container, netjes gescheiden van de andere.
Pterodactyl bestaat uit twee onderdelen:
Panel – de webinterface waarin je servers, gebruikers en resources beheert (PHP-applicatie met database en webserver)
Wings – de service op de server die de game server-containers start, stopt en controleert
In deze handleiding laten we je stap voor stap zien hoe je Panel en Wings installeert op je ZapX VPS of Dedicated Server, een domein met SSL instelt en je eerste game server aanmaakt.
Voorbereiding
Voor Pterodactyl heb je een VPS of Dedicated Server met Linux en root-toegang via SSH nodig. In onze handleiding over eerste SSH-toegang lees je hoe je verbinding maakt met je server. Nieuw bij ZapX? Bekijk dan eerst de introductie voor VPS of Dedicated Servers.
Tip
SSH-sleutelauthenticatie
We raden je aan een SSH-sleutel te gebruiken in plaats van een wachtwoord. In onze handleiding SSH-sleutels maken en gebruiken lees je hoe je dat doet.
Hardwarevereisten
Het Panel zelf is licht. Hoeveel resources je nodig hebt, hangt vooral af van het aantal game servers dat je via Wings wilt draaien. Als je Panel en Wings op dezelfde server installeert, raden we het volgende aan:
Hardware
Minimum
Aanbevolen
CPU
2 vCPU-kernen
4 vCPU-kernen of meer
RAM
4 GB
8 GB of meer
Schijfruimte
30 GB
100 GB of meer
Ondersteunde besturingssystemen
Volgens de officiële Pterodactyl-documentatie worden momenteel de volgende systemen ondersteund:
Besturingssysteem
Versies
Opmerking
Ubuntu
22.04, 24.04
Voor 22.04 heb je een extra PHP-repository nodig
Debian
11, 12, 13
PHP 8.3 komt uit de Sury-repository
Rocky Linux / AlmaLinux / RHEL
8, 9
Andere pakketnamen en paden; niet behandeld in deze handleiding
In deze handleiding vind je de opdrachten voor Ubuntu en Debian. Ubuntu 20.04 en ouder worden niet meer ondersteund door het Panel. Als je je systeem opnieuw installeert, raden we Ubuntu 24.04 of Debian 12 aan.
Virtualisatie controleren
Wings heeft Docker nodig. Docker werkt probleemloos op KVM-gebaseerde servers en Dedicated Servers, maar meestal niet op OpenVZ- of LXC-containers. Controleer dit met de volgende opdracht:
bash
systemd-detect-virt
De uitvoer kvm of none (Dedicated Server zonder virtualisatie) is prima. Staat er openvz of lxc, dan kun je Wings doorgaans niet op deze server gebruiken.
Systeem bijwerken
Werk je systeem vóór de installatie bij naar de nieuwste versie:
bash
apt update && apt upgrade -y
Firewall en poorten
Gebruik je een firewall op je server, dan moeten de volgende poorten openstaan:
Poort
Protocol
Doel
80 en 443
TCP
Panel (HTTP/HTTPS) en certificaatcontrole door Certbot
8080
TCP
Wings-API, waarmee het Panel met de node communiceert
2022
TCP
SFTP-toegang tot de bestanden van de game servers
Gamepoorten
TCP/UDP
De poorten van je allocations, bijvoorbeeld 25565 voor Minecraft
Met UFW open je de poorten bijvoorbeeld als volgt. Sta SSH eerst toe, anders sluit je jezelf buiten wanneer je de firewall inschakelt:
Docker maakt eigen regels aan voor de poorten van game server-containers. Daardoor zijn deze poorten vaak bereikbaar, zelfs als je ze niet hebt vrijgegeven in UFW. Vertrouw voor gamepoorten dus niet alleen op UFW.
FAQ
Veelgestelde vragen
Pterodactyl is een gratis, open-sourcepaneel voor het beheren van game servers. Het bestaat uit Panel (de webinterface) en Wings (de service op de server), die elke game server in een eigen Docker-container start.
Volgens de officiële documentatie Ubuntu 22.04 en 24.04, Debian 11, 12 en 13, en Rocky Linux, AlmaLinux en RHEL 8 en 9. Ubuntu 20.04 en ouder worden niet meer ondersteund door het Panel.
Het Panel heeft PHP 8.2 of 8.3 nodig. PHP 8.3 wordt aanbevolen. Op Ubuntu 22.04 en Debian haal je PHP 8.3 uit een extra repository; Ubuntu 24.04 bevat deze versie al.
Voor het Panel poort 80 en 443, voor Wings poort 8080 (API) en poort 2022 (SFTP). Daarnaast heb je de gamepoorten van je allocations nodig, bijvoorbeeld 25565 voor Minecraft.
Feedback
Was dit artikel nuttig?
Je feedback helpt ons inhoud beter te prioriteren en te verbeteren.
0 van 0 Gebruikers vonden dit artikel nuttig.
Persoonlijke hulp
Is de handleiding niet voldoende?
Onze ZAP-support kent je product — beschrijf kort je vraag en wij helpen je persoonlijk verder.
Zappy kent deze handleiding en antwoordt je direct in de chat.
Navigatie
Software
Panel downloaden
Maak de map voor het Panel aan en open deze:
bash
mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl
Download de nieuwste release, pak deze uit en stel de rechten in voor de mappen storage/ en bootstrap/cache/:
Open in het beheerdersgedeelte Servers en klik op Create New.
Geef de server een naam en kies de eigenaar (bijvoorbeeld je adminaccount).
Kies de node en een vrije allocation.
Stel in hoeveel CPU, RAM en schijfruimte de server krijgt.
Kies onder Nest en Egg de game, bijvoorbeeld Minecraft met Paper.
Klik op Create Server.
Wings downloadt nu de juiste Docker-image en installeert de server. Daarna vind je de server in de gewone weergave van het Panel. Daar kun je deze starten, de console openen en bestanden beheren.
Afronding en aanvullende informatie
Gefeliciteerd! Je hebt Pterodactyl Panel en Wings succesvol op je server geïnstalleerd en kunt nu je eigen game servers beheren via de webinterface. Deze bronnen helpen je verder:
Let op: sinds versie 1.11 verstuurt Pterodactyl anonieme gebruiksgegevens (telemetrie). In de officiële documentatie onder „Additional Configuration” lees je hoe je dit uitschakelt.
Heb je nog vragen die hier niet beantwoord zijn? Ons supportteam staat elke dag voor je klaar. Neem gerust contact met ons op! 🙂
Serverhosting vanaf € 2,49 / maand, direct online, inclusief DDoS-bescherming.
Het Panel heeft PHP 8.2 of 8.3 nodig (8.3 wordt aanbevolen), met enkele extensies, een database (MariaDB of MySQL), Redis, een webserver (we gebruiken Nginx) en curl, tar, unzip, git en Composer. Voer de opdrachten voor jouw distributie uit.
Ubuntu 24.04
PHP 8.3, MariaDB en Redis zijn bij Ubuntu 24.04 al beschikbaar in de standaardpakketbronnen. Je hebt dus geen extra repositories nodig:
Ubuntu 22.04 bevat alleen PHP 8.1. Voeg daarom eerst de PHP-repository van Ondřej Surý en de officiële Redis-repository toe en installeer daarna alle pakketten:
Kopieer de voorbeeldconfiguratie, installeer de PHP-afhankelijkheden en genereer de sleutel van de applicatie:
bash
cp .env.example .env
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
# Nur bei einer Neuinstallation ausführen, nicht bei einem bestehenden Panel
php artisan key:generate --force
Let op
APP_KEY veilig bewaren
De waarde APP_KEY in het bestand versleutelt alle gevoelige gegevens van het Panel, zoals API-sleutels. Als je deze kwijtraakt, kun je die gegevens ook met een databaseback-up niet meer lezen. Bekijk de sleutel met en bewaar deze op een veilige plek buiten de server, bijvoorbeeld in je wachtwoordmanager.
Cronjob en Queue Worker instellen
Het Panel voert veel taken op de achtergrond uit, zoals geplande taken, e-mails en opruimwerkzaamheden. Daarvoor heb je een cronjob en een Queue Worker nodig.
Cronjob
Open de crontab met sudo crontab -e en voeg deze regel toe. Hiermee wordt de scheduler van het Panel elke minuut gestart:
Sla op met STRG + X, daarna en . Schakel vervolgens Redis en de Queue Worker in, zodat ze ook na een herstart automatisch actief zijn:
Webserver en SSL instellen
Stel DNS, een SSL-certificaat en Nginx in om het Panel via je eigen domein met HTTPS te bereiken.
DNS-record aanmaken
Maak bij je domeinprovider een A-record aan dat verwijst naar het IP-adres van je server, bijvoorbeeld panel.example.com. Staat je domein bij ZAP-Hosting, bekijk dan onze handleiding over domeinrecords. Het kan even duren voordat het record wereldwijd actief is.
SSL-certificaat maken met Certbot
Installeer Certbot met de Nginx-plug-in en maak het certificaat aan. Vervang panel.example.com door je domein:
Certbot controleert het domein via poort 80. Die poort moet dus bereikbaar zijn vanaf internet. Meer over Certbot lees je in onze handleiding Certbot instellen op een Linux-server.
Het Certbot-pakket verlengt certificaten automatisch. Om ervoor te zorgen dat Nginx en Wings een vernieuwd certificaat ook laden, kun je deze regel toevoegen aan de crontab (sudo crontab -e):
Maak een nieuw configuratiebestand voor het Panel:
bash
nano /etc/nginx/sites-available/pterodactyl.conf
Voeg deze configuratie toe en vervang panel.example.com op alle vier de plekken door je domein:
Wings installeren
Wings is de service die je game servers daadwerkelijk uitvoert. Je kunt Wings op dezelfde server als het Panel installeren of op extra servers, die je vervolgens als extra nodes aan het Panel toevoegt.
Docker installeren
Wings start elke game server in een Docker-container. Installeer Docker CE met het officiële installatiescript en schakel de service in:
Debian 13 wordt standaard geleverd met PHP 8.4, dat Pterodactyl niet officieel ondersteunt. Haal daarom PHP 8.3 uit de Sury-repository. Installeer MariaDB en Redis rechtstreeks uit de Debian-pakketbronnen, zonder extra repositories:
Met de volgende opdrachten stel je sessies, cache, de databaseverbinding en e-mail in. Je wordt tijdens het uitvoeren gevraagd om de waarden:
bash
php artisan p:environment:setup
php artisan p:environment:database
# Optional: Mailversand einrichten ("smtp" für einen eigenen Mailserver)
php artisan p:environment:mail
Voer bij de vraag naar de Application URL het toekomstige adres van je Panel in, bijvoorbeeld https://panel.example.com. Gebruik voor de database 127.0.0.1, de database panel, de gebruiker pterodactyl en het wachtwoord dat je eerder hebt ingesteld. Voor cache, sessies en de wachtrij kun je Redis kiezen.
Database vullen
Het Panel maakt nu de tabellen aan en importeert de meegeleverde Nests en Eggs (de sjablonen voor de afzonderlijke games):
bash
php artisan migrate --seed --force
Info
Even wachten
Dit kan een paar minuten duren. Onderbreek het proces niet, anders is de database onvolledig.
Eerste admin aanmaken
Maak je adminaccount aan. Het wachtwoord moet minstens 8 tekens lang zijn en hoofdletters, kleine letters en minstens één cijfer bevatten:
bash
php artisan p:user:make
Beantwoord de vraag of de gebruiker een beheerder moet zijn met yes.
Rechten instellen
Geef de bestanden aan de webservergebruiker, zodat Nginx en PHP er toegang toe hebben:
Nginx start met deze configuratie alleen als het SSL-certificaat al bestaat. Maak het certificaat daarom eerst aan met Certbot.
Nginx configureren zonder SSL
Wil je het Panel alleen testen en nog geen domein met certificaat gebruiken? Dan kun je in plaats daarvan deze eenvoudigere configuratie gebruiken in /etc/nginx/sites-available/pterodactyl.conf. Vervang panel.example.com door je domein of het IP-adres van je server en verwijder ook hier eerst het bestand /etc/nginx/sites-enabled/default:
Open nu https://panel.example.com in je browser en meld je aan met het adminaccount dat je eerder hebt aangemaakt. Algemene informatie over Nginx vind je in onze handleiding Nginx en Apache instellen op een Linux-server.
Open rechtsboven in het Panel het beheerdersgedeelte (tandwielpictogram).
Maak onder Locations met Create New een locatie aan, bijvoorbeeld met de afkorting de1.
Ga naar Nodes en klik op Create New.
Voer een naam in, kies de locatie en vul bij FQDN het domein van de server in. Draait Wings op dezelfde server als het Panel, dan kun je hetzelfde domein gebruiken, bijvoorbeeld panel.example.com.
Kies bij Communicate Over SSL de optie Use SSL Connection als je Panel via HTTPS bereikbaar is. De node heeft dan ook een geldig certificaat voor zijn FQDN nodig.
Vul bij Total Memory en Total Disk Space in hoeveel RAM en schijfruimte Wings aan game servers mag toewijzen. Houd wat ruimte over voor het systeem zelf.
Laat Daemon Port op 8080 en Daemon SFTP Port op 2022 staan en sla de node op.
Open daarna de node en ga naar het tabblad Configuration. Klik op Generate Token en voer de getoonde opdracht uit op je server. Hiermee wordt het bestand /etc/pterodactyl/config.yml automatisch aangemaakt. Je kunt de inhoud van het codeblok ook handmatig naar dit bestand kopiëren.
Wings testen
Start Wings één keer in de debugmodus om fouten direct te zien:
bash
sudo wings --debug
Als Wings zonder fouten draait en de node in het Panel onder Nodes een groen hartje laat zien, stop je de test met STRG + C.
Wings als service instellen
Maak een systemd-service aan om Wings continu op de achtergrond te laten draaien:
Een allocation is een combinatie van een IP-adres en poort die je aan een game server toewijst. Elke server heeft er minstens één nodig. Je vindt het IP-adres van je server met:
bash
hostname -I | awk '{print $1}'
Open je node in het beheerdersgedeelte, ga naar het tabblad Allocation en vul onder Assign New Allocations het IP-adres en de gewenste poorten in, bijvoorbeeld 25565-25570 voor Minecraft. Gebruik nooit 127.0.0.1 als allocation.
Voorkeursbron bij Google
