Pterodactyl: what it is and how to install it on a VPS

Pterodactyl here is not the flying reptile: it is an open source panel for creating and managing game servers from a browser. This guide explains how it works and what kind of machine it needs, then installs it step by step on an Ubuntu 24.04 VPS: the panel with PHP 8.3, MariaDB, Redis and nginx, HTTPS with certbot, then Wings and Docker to run the servers. The commands follow the official Pterodactyl documentation and are run as root.

The essentials

  • Pterodactyl is two pieces of software: the web panel (PHP, MariaDB, Redis) and Wings, which runs each game server in a Docker container.
  • You need a KVM VPS running Ubuntu, Debian, Rocky or AlmaLinux, a domain for HTTPS and 2 GB of RAM for the panel alone.
  • With Wings on the same machine, the RAM you need is the panel's plus that of every game server.
  • Back up the .env file (APP_KEY), the panel database and the server volumes, off the VPS.
ACLClouds
ACLClouds

Pterodactyl: what it is and how to install it on a VPS

The Pterodactyl panel and its Wings daemon explained, then a full install on a Debian or Ubuntu VPS: PHP, MariaDB, Redis, nginx, certbot, Docker and

Pterodactyl here is not the flying reptile: it is an open source panel for creating and managing game servers from a browser. This guide explains how it works and what kind of machine it needs, then installs it step by step on an Ubuntu 24.04 VPS: the panel with PHP 8.3, MariaDB, Redis and nginx, HTTPS with certbot, then Wings and Docker to run the servers. The commands follow the official Pterodactyl documentation and are run as root.

  • Pterodactyl is two pieces of software: the web panel (PHP, MariaDB, Redis) and Wings, which runs each game server in a Docker container.
  • You need a KVM VPS running Ubuntu, Debian, Rocky or AlmaLinux, a domain for HTTPS and 2 GB of RAM for the panel alone.
  • With Wings on the same machine, the RAM you need is the panel's plus that of every game server.
  • Back up the .env file (APP_KEY), the panel database and the server volumes, off the VPS.

What is Pterodactyl?

Pterodactyl is a game server management panel released under the MIT licence. It is made of two pieces of software: the panel, a PHP web application that stores accounts, servers and settings, and Wings, a daemon written in Go that starts each game server in its own Docker container. One panel can drive several Wings machines, called nodes.

  • The panel: web interface, API, MariaDB or MySQL database, cache and job queue in Redis.
  • Wings: node API on port 8080 and SFTP on port 2022 by default, Docker containers for the servers.
  • Eggs: server templates (Minecraft Paper, Rust, ARK, bots and more) that describe the Docker image, the install script and the startup command.
  • Each player or customer gets access to their own servers: console, files, backups, scheduled tasks and sub-users.

Requirements: OS, RAM and virtualisation

The official documentation supports Ubuntu 22.04 and 24.04, Debian 11, 12 and 13, and Rocky Linux and AlmaLinux 8 and 9. The panel needs PHP 8.2 or 8.3, MariaDB 10.2 or newer (or MySQL 5.7.22 and up), Redis, a web server and Composer 2. Wings needs Docker and full virtualisation: KVM works, while OpenVZ and LXC almost always cause trouble.

  • Check the virtualisation with systemd-detect-virt: the output must not contain openvz or lxc. ACLClouds VPS are KVM machines.
  • RAM: the panel alone fits in 2 GB. With Wings on the same machine, add the memory of each game server, for example 4 GB for a Minecraft Paper server with about ten players.
  • A domain name pointing to the VPS IP is required for HTTPS; a free subdomain under aclclouds.online works.
  • For the panel plus one or two small servers, the Mini plan (8 GB RAM, 2 vCPU) is enough; beyond that, the Essentiel plan (16 GB, 4 vCPU) leaves headroom. See Linux VPS plans.

Install PHP, MariaDB, Redis and nginx

On Ubuntu 24.04, PHP 8.3 comes from the ondrej/php repository. First update the system with apt update && apt -y upgrade, then install the dependencies and Composer. On Debian, the official documentation has a dedicated page with a different PHP repository: follow it instead of these commands.

  • apt -y install software-properties-common curl apt-transport-https ca-certificates gnupg
  • LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php && apt update
  • apt -y install php8.3 php8.3-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} mariadb-server nginx tar unzip git redis-server
  • curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

Download the panel and create the database

The panel goes into /var/www/pterodactyl, from the archive of the latest release on GitHub. Then create a MariaDB database and a user that only the panel uses, with a long, unique password.

  • 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 -xzvf panel.tar.gz && chmod -R 755 storage/* bootstrap/cache/
  • In mariadb -u root -p: CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'uniquePassword'; CREATE DATABASE panel; GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1';
  • cp .env.example .env && COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
  • php artisan key:generate --force: the APP_KEY encrypts some panel data. Copy it off the server, because without it a restore is impossible.

Configure the environment and create the admin account

Three interactive wizards fill in the .env file: the panel URL and the cache, session and queue drivers (pick Redis), then the database connection, then outgoing email. The migration then creates the tables and the bundled eggs, and the last command creates the first admin account.

  • php artisan p:environment:setup, then php artisan p:environment:database and php artisan p:environment:mail
  • php artisan migrate --seed --force: do not interrupt it, importing the eggs takes a while.
  • php artisan p:user:make: answer yes to the administrator question.
  • chown -R www-data:www-data /var/www/pterodactyl/*: the files belong to the web server user.

Enable the scheduler and the queue worker

The panel needs a cron job that runs every minute (cleanup, scheduled server tasks) and a worker that processes the Redis queue. Without the worker, server creation and emails stay stuck.

  • crontab -e, then the line: * * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1
  • Create /etc/systemd/system/pteroq.service with User=www-data, Group=www-data, Restart=always and ExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
  • systemctl enable --now redis-server, then systemctl enable --now pteroq.service

Set up nginx and HTTPS with certbot

First point an A record of the domain, for example panel.example.com, to the VPS IPv4. Then get the certificate with the certbot nginx plugin and create the panel server block from the nginx-with-SSL template in the official documentation: root /var/www/pterodactyl/public, PHP passed to the PHP-FPM 8.3 socket, and the paths of the certificate you obtained.

  • apt -y install certbot python3-certbot-nginx, then certbot certonly --nginx -d panel.example.com
  • In /etc/nginx/sites-available/pterodactyl.conf: server_name panel.example.com, ssl_certificate /etc/letsencrypt/live/panel.example.com/fullchain.pem and fastcgi_pass unix:/run/php/php8.3-fpm.sock.
  • rm /etc/nginx/sites-enabled/default, ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/, then nginx -t && systemctl restart nginx
  • Renewal is automatic through the certbot timer; test it with certbot renew --dry-run. The details are in the free HTTPS certificate guide.

Install Docker and Wings, then link the node

Wings can run on the same VPS as the panel or on another machine. Install Docker with the official script, then the Wings binary. In the panel, create a Location, then a node with its domain name, the SSL option, and the memory and disk to share. The node's Configuration tab shows the config.yml content to copy into /etc/pterodactyl.

  • curl -sSL https://get.docker.com/ | CHANNEL=stable bash && systemctl enable --now docker
  • mkdir -p /etc/pterodactyl && curl -L -o /usr/local/bin/wings https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64 && chmod u+x /usr/local/bin/wings
  • Run wings --debug once to see any errors, then create the wings.service unit (ExecStart=/usr/local/bin/wings, after docker.service) and enable it with systemctl enable --now wings.
  • Add allocations to the node: the public IP shown by hostname -I, never 127.0.0.1, and a port range, for example 25565-25600.
  • The panel shows a green heart next to the node when Wings responds; if not, check the certificate and port 8080.

Secure the panel and the nodes

A game panel exposes an admin interface, an API and game ports, which makes it a target. Open only the ports you need, protect the accounts and back up whatever cannot be reinstalled. The basics of hardening a VPS are in our Linux security guide.

  • Firewall: 22 (SSH), 80 and 443 for the panel, 8080 and 2022 for Wings, then the allocation ports, TCP and UDP depending on the game.
  • Turn on two-factor authentication for admin accounts and disable SSH password login.
  • Back up the .env file, the panel database (mysqldump panel) and the server data in /var/lib/pterodactyl/volumes, then copy them off the VPS.
  • Update the panel with php artisan p:upgrade and Wings by replacing the binary, after a backup, following the release notes.

Nothing to install: the ACLClouds options

If you want your own panel without going through these steps, the preconfigured Pterodactyl VPS installs the panel, MariaDB, Redis, the queue worker and HTTPS from your domain and credentials. The Pterodactyl + Wings VPS adds Docker and Wings, with the node, its config.yml and 100 allocations already created. You keep root access in both cases.

  • These images cost the same as the other VPS: the preconfigured install is included.
  • If you only want to play, without running a server yourself, our game servers run on the ACLClouds panel, built on Pterodactyl and Wings: the server is delivered ready, with nothing to install on your side.

Frequently asked questions

Is Pterodactyl free?

Yes. The panel and Wings are released under the MIT licence, with no limit on servers or users. You only pay for the machine that runs them.

How much RAM does Pterodactyl need?

The panel alone runs with 2 GB. If Wings runs on the same VPS, add up the memory of each game server: 8 GB covers one or two small servers, 16 GB several medium ones.

Can Pterodactyl be installed on Windows?

No. The panel and Wings are built for Linux, and Wings does not run on Windows. Use a Linux VPS, or a Linux virtual machine on your PC for testing.

Does Pterodactyl need a domain name?

For real use, yes: HTTPS on the panel and the secure connection between the panel and Wings rely on a certificate tied to a name. A free aclclouds.online subdomain is enough.