How to Install Pterodactyl Panel on a VPS
Install the Pterodactyl game-server panel and Wings daemon on a Ryzen VPS — dependencies, database, Nginx and SSL, Docker, and your first node and server. A step-by-step 2026 guide.
On this page
Pterodactyl is a free, open-source game-server management panel — the same kind of control panel many hosting companies build on. It gives you a clean web dashboard to create and manage game servers (Minecraft, Discord bots, Rust, FiveM and more), each isolated in its own Docker container. This guide walks through a complete single-machine install on an Ubuntu VPS: the Panel, Nginx with SSL, the Wings daemon, and your first node and server.
Everything here runs comfortably on a Kerit Cloud KVM VPS — you get full root, a dedicated IPv4 and NVMe storage, exactly what Wings and Docker want. New to managing a server? Read your first 30 minutes on a new VPS first, then come back.
What you need
- A 64-bit Ubuntu 22.04 / 24.04 (or Debian 12) VPS with root access.
- 2 GB RAM or more — the Panel and Wings are light, but your game servers are not. Size the VPS for the servers you plan to run.
- A domain or subdomain pointed at your VPS IP (for example
panel.example.com) so you can secure the Panel with HTTPS. - Software: PHP 8.3, MariaDB, Redis, Nginx and Composer for the Panel, plus Docker for Wings.
Point your domain's A record at your VPS's dedicated IPv4 before you start, so the SSL step works on the first try.
Step 1: Prepare the VPS
Update the system and add the PHP repository:
sudo apt update && sudo apt upgrade -y
sudo apt install -y software-properties-common curl ca-certificates gnupg
sudo add-apt-repository -y ppa:ondrej/php
sudo apt update
Install the Panel's dependencies — PHP 8.3 with the required extensions, MariaDB, Nginx and Redis — and Composer:
sudo apt install -y php8.3 php8.3-{cli,gd,mysql,pdo,mbstring,tokenizer,bcmath,xml,fpm,curl,zip} \
mariadb-server nginx redis-server tar unzip git
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer
Step 2: Install the Panel
Create a database and user for the Panel:
sudo mysql -u root
CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'CHANGE_ME';
CREATE DATABASE panel;
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;
FLUSH PRIVILEGES;
EXIT;
Download the Panel files into /var/www/pterodactyl:
sudo mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl
sudo curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz
sudo tar -xzvf panel.tar.gz
sudo chmod -R 755 storage/* bootstrap/cache/
Install dependencies and run the guided setup — it writes your .env, keys and database tables, then creates your admin login:
sudo cp .env.example .env
sudo composer install --no-dev --optimize-autoloader
sudo php artisan key:generate --force
sudo php artisan p:environment:setup
sudo php artisan p:environment:database
sudo php artisan migrate --seed --force
sudo php artisan p:user:make
Hand the files to the web-server user, then add the scheduler cron and the queue worker:
sudo chown -R www-data:www-data /var/www/pterodactyl/*
( sudo crontab -l 2>/dev/null; echo "* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1" ) | sudo crontab -
Create the queue worker as a systemd service at /etc/systemd/system/pteroq.service (copy the unit from the official docs), then enable Redis and the worker:
sudo systemctl enable --now redis-server
sudo systemctl enable --now pteroq.service
Step 3: Nginx and SSL
Get a free TLS certificate with Certbot, then install Pterodactyl's Nginx config (replace the domain with yours):
sudo apt install -y certbot python3-certbot-nginx
sudo certbot certonly --nginx -d panel.example.com
Copy the official SSL Nginx template to /etc/nginx/sites-available/pterodactyl.conf, set server_name to your domain, enable it and restart:
sudo ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/
sudo rm /etc/nginx/sites-enabled/default
sudo nginx -t && sudo systemctl restart nginx
Open https://panel.example.com and log in with the admin user you created. The Panel is live.
Step 4: Install Wings
Wings runs the game servers in Docker, so install Docker first:
curl -sSL https://get.docker.com/ | CHANNEL=stable sudo bash
sudo systemctl enable --now docker
Install the Wings binary:
sudo mkdir -p /etc/pterodactyl
sudo curl -L -o /usr/local/bin/wings "https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64"
sudo chmod u+x /usr/local/bin/wings
Step 5: Create a node
In the Panel, open Admin → Locations and add a location (for example Miami). Then go to Admin → Nodes → Create New, point it at your domain (or a node.example.com subdomain on the same server), and set the memory and disk this node may hand out.
Open the node's Configuration tab, generate the token, and run the command it gives you — it writes /etc/pterodactyl/config.yml on the VPS. Create the Wings systemd service at /etc/systemd/system/wings.service (from the docs) and start it:
sudo systemctl enable --now wings
Back in the Panel the node's heart icon turns green — Panel and Wings are talking. Add the ports your servers will use under the node's Allocation tab (for example your.ip:25565 for Minecraft).
Step 6: Deploy your first server
Go to Admin → Servers → Create New, pick the owner, the node and an egg — Pterodactyl's name for a server template, such as Paper, Fabric, a Discord bot or Rust. Assign RAM, disk and an allocation, then create it. Wings pulls the Docker image, installs the server, and you can start it from the client dashboard.
That's a full working panel: create more users, hand them servers, and run everything from the web UI — no SSH needed for day-to-day use.
Choosing a VPS plan
The Panel and Wings together use roughly 1 GB of RAM; the rest is for your game servers. Add up what each server needs, leave about 1 GB of headroom for the host, and pick a plan to match:
- A couple of small servers or bots — the $3 Nano or Basic plan (2–4 GB) is plenty.
- A busy Minecraft server, or several at once — step up to Plus or Pro (8–16 GB) for the headroom.
Every Kerit Cloud VPS runs on an AMD Ryzen 7 5700X with NVMe PCIe 4.0 storage and Cloudflare Magic Transit DDoS protection — the high single-thread speed keeps game-server tick rates smooth. If you would rather not run the panel yourself, our managed Minecraft hosting gives you a one-click panel we maintain for you.
Frequently asked questions
Is Pterodactyl free?
Yes — it is open-source and free to self-host. You only pay for the VPS it runs on, from $3/month.
Can the Panel and Wings run on one VPS?
Yes, that is the standard way to start. As you grow, move Wings onto separate VPSes and add them as extra nodes in the same Panel.
Which games can I host?
Anything with an egg — Minecraft (Paper, Fabric, Forge, vanilla), Discord bots, Rust, FiveM, Terraria and many more, plus community eggs.
Summary
Pterodactyl turns a plain VPS into a full game-server control panel: install the Panel (PHP, MariaDB, Redis, Nginx, Composer), secure it with Certbot, install Wings on Docker, add a node, and deploy servers from eggs. On a Ryzen 7 NVMe VPS with a dedicated IPv4 it runs fast and stays online.
Ready to build your panel? Get a Ryzen VPS from $3/mo →