Skip to main content

Pterodactyl Installation Guide

Pterodactyl is an open-source game server management panel built with PHP, React, and Go.
This guide covers Panel + Wings (Daemon) installation on a fresh Ubuntu 22.04 / 24.04 server.

Prerequisites

Before you begin, ensure you have:

Install System Dependencies

Add PHP and Redis repositories:
Install required packages:

Step 1: Configure MariaDB

Log into MySQL and create a database + user:

Step 2: Install the Panel

Install dependencies:

Configure Environment

Open .env and edit database + app settings:
Example values:
Migrate and seed the database:

Set Permissions


Step 3: NGINX Configuration

Create new site config:
Paste this:
Enable the site:

Step 4: Secure with SSL

Install Certbot and generate certificates:
Auto-renew setup:

Step 5: Setup Cron & Queue

Add to crontab:
(Optional) Start queue worker manually:

Step 6: Install Wings (Daemon)

Install Docker

Install Wings

Configure Wings

In your Panel → Nodes → Configuration, copy the generated YAML config and paste it into:

Create Systemd Service

Paste:
Enable and start:

Step 7: Access Panel

Open your browser and go to:
You’ll be guided through initial setup.

Troubleshooting


References


Tip: For faster installs, check out pterodactyl-installer (unofficial).

Your panel is now live! Login at your domain, connect nodes, and start deploying game servers.