Met onze eigen Pterodactyl-installer zet je het Pterodactyl Panel en/of Wings in een paar stappen op je VPS, grotendeels via je browser. Je hebt hier verder geen technische kennis voor nodig.

Let op! Niet verbonden aan het officiële Pterodactyl-project. Pterodactyl® is een geregistreerd handelsmerk van zijn eigenaren. Onze installer is gebaseerd op het open source pterodactyl-installer van Vilhelm Prytz, aangepast en uitgebreid door Etheron Hosting.

Vereisten

• Een verse VPS, zonder andere software erop. Draai je al een panel? Gebruik dan de officiële Pterodactyl-handleiding om te upgraden, niet deze installer.
• Een van de volgende besturingssystemen:

Besturingssysteem	Versies
Ubuntu	22.04, 24.04, 26.04
Debian	12, 13
Rocky Linux	8, 9, 10
AlmaLinux	8, 9, 10

• Root-toegang op je VPS.
• De benodigde poorten open (zie de tabel bij Poorten hieronder). Heeft je hostingprovider (zoals wij) een eigen firewall? Zet de poorten daar ook open.

Stap 1. Verbinding maken via SSH

1. Log in op je VPS via SSH, bijvoorbeeld met PuTTY of de terminal van je computer.
2. Log in als root, of word root met sudo -i.

Let op! Tijdens het invullen van je wachtwoord zie je niets terugverschijnen in het scherm, dit is normaal gedrag bij SSH.

Stap 2. curl installeren

Kopieer en plak het commando dat bij jouw besturingssysteem past:

Ubuntu of Debian:

apt update && apt install -y curl

Rocky Linux of AlmaLinux:

dnf install -y curl

Stap 3. De installer starten

Kopieer en plak dit commando:

bash <(curl -fsSL https://raw.githubusercontent.com/etheronhosting/Pterodactyl-install-script-etheron-hosting/main/install.sh) web

De installer zet Python en OpenSSL klaar, vraagt een gratis certificaat aan, en start vervolgens een installatiewizard op poort 8443.

Stap 4. De wizard openen in je browser

1. In de terminal verschijnt een link met een eenmalige toegangscode, bijvoorbeeld https://installer-203-0-113-10.sslip.io:8443/?token=....
2. Open deze link in je browser. Je mag het SSH-venster hierna rustig sluiten, de installatie loopt vanaf nu volledig via je browser.

Let op! Krijg je een waarschuwing over het certificaat in je browser? Dat kan gebeuren als poort 80 nog niet open stond. Je mag dan gewoon doorklikken. Controleer bij twijfel of de vingerafdruk van het certificaat overeenkomt met wat er in de terminal stond.

Stap 5. Kiezen wat je installeert

In de wizard kies je:

• Wat je wilt installeren: Panel, Wings, of beide samen op één server.
• Hoe je server bereikbaar moet zijn:

Keuze	Adres	HTTPS
Eigen domein	bijv. panel.jouwdomein.nl (zet een A-record naar je VPS)	Gratis via Let's Encrypt (aanbevolen)
Gratis adres (nip.io)	bijv. 203-0-113-10.nip.io	Gratis via Let's Encrypt
Alleen IP-adres	bijv. 203.0.113.10	Geen, alleen geschikt om te testen

Geen eigen domein? Geen probleem, nip.io geeft je automatisch een gratis adres dat naar je server wijst. Je hoeft hier zelf niets voor in te stellen.

Let op! Gebruik je Cloudflare voor je domein? Zet de proxy (het oranje wolkje) uit voor dit record, anders kan het certificaat niet aangevraagd worden.

Wil je een eigen certificaat gebruiken in plaats van Let's Encrypt? Plaats het certificaat in /etc/ssl/<domein>.pem en de sleutel in /etc/ssl/<domein>.key, en herstart nginx met nginx -t && systemctl restart nginx.

Stap 6. Gegevens invullen en installeren

1. Maak een beheerdersaccount aan voor het Panel.
2. Vul, indien van toepassing, de Wings-opties in.
3. De installer controleert alles voordat er daadwerkelijk iets geïnstalleerd wordt.
4. Volg de installatie live in de wizard. Je mag de pagina sluiten en later weer openen met dezelfde link, de installatie loopt op de achtergrond door.

Let op! De webinstaller sluit zichzelf automatisch af: 30 minuten na een voltooide installatie, na 1 uur zonder gebruik, na 24 uur, of wanneer je zelf op Webinstaller afsluiten klikt.

Stap 7. Node aanmaken en Wings starten

Klik aan het einde van de wizard op Node aanmaken en Wings starten. Dit regelt automatisch:

• Het aanmaken van een locatie (standaard nl).
• Het aanmaken van een node, met het geheugen en de vrije schijfruimte van je VPS.
• Het toevoegen en openzetten van de poorten voor gameservers (standaard 25565–25600).
• Het configureren en starten van Wings.

Je hebt nu Pterodactyl geïnstalleerd op je VPS!

Draait je Panel op een andere server dan Wings? Dan heb je een API-sleutel uit het Panel nodig (Admin → Application API → Create New), met Read & Write op Locations, Nodes en Allocations.

Databases voor gameservers

Bij het instellen van Wings kies je uit drie opties:

Optie	Wat er gebeurt
Automatisch	De installer maakt alles zelf aan en zet de databasehost direct in het panel. Alleen beschikbaar als Panel en Wings op dezelfde server staan.
Zelf instellen	Je kiest zelf een gebruikersnaam en wachtwoord. Voeg de databasehost daarna handmatig toe via Admin → Databases.
Niet nodig	Er wordt niets ingesteld.

Let op! Kies je Automatisch, dan is de database alleen bereikbaar vanuit de gameservers zelf. Van buitenaf blijft poort 3306 dicht.

Poorten

De installer zet deze poorten zelf open op de VPS. Heeft je hostingprovider een eigen, aparte firewall? Zet ze daar ook open, anders werkt het niet.

Onderdeel	Poorten	Wanneer
SSH	meestal 22	altijd
Panel	80, 443 (TCP)	bij installatie van het Panel
Wings	8080, 2022 (TCP)	bij installatie van Wings
Wings met HTTPS	80, 443 (TCP)	als je een certificaat voor Wings gebruikt
Gameservers	standaard 25565–25600 (TCP en UDP)	bij het koppelen van de node
Webinstaller	8443 (TCP), tijdelijk	zolang de webinstaller draait

Problemen oplossen

• De link in de terminal werkt niet: controleer of poort 8443 open staat, en of je de volledige link (inclusief ?token=...) hebt gekopieerd.
• Het certificaat voor je eigen domein lukt niet: controleer of het A-record daadwerkelijk naar je VPS wijst, en of Cloudflare's proxy (oranje wolkje) uit staat voor dit record.
• Wings start niet na het aanmaken van de node: controleer of de juiste poorten (zie de tabel bij Poorten) openstaan, zowel op de VPS zelf als bij een eventuele externe firewall.

Mocht het niet lukken, neem dan contact met ons op via Discord of maak een ticket aan!