How to Install Pterodactyl Panel & Wings on an Ubuntu VPS (Complete 2026 Guide)
How to Install Pterodactyl Panel & Wings on Ubuntu 22.04
Pterodactyl is the premier open-source game management panel used by hosting providers and gaming communities worldwide. This guide walks you through deploying both the Pterodactyl Web Panel and the Wings Daemon on an Ash Host Cloud VPS.
Recommended Hardware Specifications
- Operating System: Clean Ubuntu 22.04 LTS (64-bit)
- Processor: At least 2 Virtual CPU Cores (KVM Virtualization)
- RAM: 2 GB minimum for Panel only; 4 GB to 8 GB+ if running Wings & game servers on the same node
- Storage: 20 GB+ Gen4 NVMe disk space
- Domain Name: An active domain or subdomain (e.g.,
panel.yourdomain.com) pointed to your VPS IP via an A Record
Method 1: The Automated 1-Click Installer (Recommended)
The open-source Pterodactyl community auto-installer handles PHP dependencies, MariaDB databases, Nginx reverse proxy, Docker engine, and Let's Encrypt SSL certificates automatically without manual configuration errors.
- Log in to your Ash Host VPS as
rootvia SSH. - Run the official community installation script:
bash <(curl -s https://pterodactyl-installer.se)
- When prompted by the installer menu:
- Type
0to install Both the Panel and Wings on this server. - Enter your database credentials (or press Enter to let the script generate secure random passwords).
- Enter your fully qualified domain name (e.g.
panel.yourdomain.com). - Select Yes to automatically configure Let's Encrypt SSL.
- Provide your email address for initial admin account creation and SSL expiration notices.
- Type
- Wait 3 to 5 minutes while packages, Docker, and Composer dependencies compile. Once complete, you will receive a confirmation message with your admin login URL.
Method 2: Manual Production Setup (Step-by-Step)
If you prefer configuring every service manually, follow the official Pterodactyl architecture steps below:
Step 1: Install Dependencies (PHP 8.2, MariaDB, Nginx, Redis)
# Update repositories and install software properties
apt update && apt upgrade -y
apt install -y software-properties-common curl apt-transport-https ca-certificates gnupg
# Add PHP PPA repository
add-apt-repository -y ppa:ondrej/php
apt update
# Install Nginx, MariaDB, Redis and PHP 8.2 with required extensions
apt install -y nginx mariadb-server redis-server certbot python3-certbot-nginx \
php8.2 php8.2-{cli,common,gd,mysql,mbstring,bcmath,xml,curl,zip,intl} tar unzip git
# Install Composer
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
Step 2: Create MariaDB Database & User
Log in to the MariaDB console:
mysql -u root
Execute the following SQL commands (replace YourSecurePasswordHere with a strong password):
CREATE DATABASE panel;
CREATE USER 'ptero'@'127.0.0.1' IDENTIFIED BY 'YourSecurePasswordHere';
GRANT ALL PRIVILEGES ON panel.* TO 'ptero'@'127.0.0.1' WITH GRANT OPTION;
FLUSH PRIVILEGES;
EXIT;
Step 3: Download & Install Pterodactyl Panel
# Create directory and download panel release
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/
# Copy environment configuration and install composer dependencies
cp .env.example .env
composer install --no-dev --optimize-autoloader
# Generate application encryption key
php artisan key:generate --force
Step 4: Configure Database and Run Migrations
# Run interactive environment setup (enter domain, timezone, redis, and mail settings)
php artisan p:environment:setup
php artisan p:environment:database
# Run database schema migrations
php artisan migrate --seed --force
# Create your first administrator account
php artisan p:user:make
# Set correct ownership permissions
chown -R www-data:www-data /var/www/pterodactyl/*
Step 5: Configure Background Queue Worker (pteroq.service)
Pterodactyl requires a background queue worker for email delivery, automated tasks, and server statistics. Create the systemd service:
nano /etc/systemd/system/pteroq.service
Paste the following service definition:
[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
Enable and start the worker service:
systemctl daemon-reload
systemctl enable --now pteroq.service
Step 6: Open Required Firewall Ports (UFW)
Ensure all ports required for Pterodactyl Panel, Wings communication, SFTP, and game server traffic are open:
# SSH and Web Panel Ports
ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
# Wings Daemon & SFTP Ports
ufw allow 8080/tcp
ufw allow 2022/tcp
# Game Server Port Allocation Range (example)
ufw allow 25565:25600/tcp
ufw allow 25565:25600/udp
# Enable firewall
ufw enable
Troubleshooting Common Pterodactyl Errors
| Error | Cause & Immediate Fix |
|---|---|
500 Server Error on visiting Panel |
Incorrect file permissions or missing .env file. Run chown -R www-data:www-data /var/www/pterodactyl/* and inspect storage/logs/laravel-*.log. |
Wings: Red Heart / Cannot Connect |
Port 8080 is blocked by UFW firewall, or your SSL certificate on Wings does not match the Panel's HTTPS domain (CORS mismatch). |
419 Page Expired / CSRF Token Mismatch |
APP_URL in your .env does not match the exact URL in your browser bar (e.g., using http:// instead of https://). |
Deploy a High-Performance Game Node VPS Today
Ash Host Singapore AMD EPYC and Canada VPS plans provide high single-core speeds, NVMe disk I/O, and enterprise DDoS filtering engineered for Pterodactyl game nodes.
Order High-RAM VPS for Pterodactyl →Hjalp dette svar dig?
Relaterede artikler
Powered by WHMCompleteSolution