Pterodactyl Panel

Pterodactyl® is a free, open-source game server management panel built with PHP, React, and Go. Designed with security in mind, Pterodactyl runs all game servers in isolated Docker containers while exposing a beautiful and intuitive UI to end users.

Stop settling for less. Make game servers a first class citizen on your platform.

Installation

This will update your panel to the latest version of NookTheme panel is based.
You can see the version in the current branch name.

Upgrade PHP

Before proceeding with the installation steps, ensure that your PHP version is upgraded to 8.2 or newer. Follow the instructions below to upgrade PHP:

1. Update your package list:

sudo apt update

2. Install the required dependencies:

sudo apt install -y software-properties-common

3. Add the PHP repository:

sudo add-apt-repository ppa:ondrej/php

4. Update your package list again:

sudo apt update

5. Install PHP 8.3:

sudo apt install -y php8.3

6. Verify the PHP version:

php -v

Enter Maintenance Mode

Whenever you are performing an update you should be sure to place your Panel into maintenance mode. This will prevent users from encountering unexpected errors and ensure everything can be updated before users encounter potentially new features.

cd /var/www/pterodactyl

php artisan down

Download the theme

The first step in the update process is to download the new panel files from GitHub. The command below will download the release archive for the most recent version of Pterodactyl, save it in the current directory and will automatically unpack the archive into your current folder.

curl -L https://github.com/JsemOlik/sigmure/releases/download/v1.11.10/sigmure-release-v1.11.10.tar.gz | tar -xzv

Once all of the files are downloaded we need to set the correct permissions on the cache and storage directories to avoid any webserver related errors.

chmod -R 755 storage/* bootstrap/cache

Update Dependencies

After you've downloaded all of the new files you will need to upgrade the core components of the panel. To do this, simply run the commands below and follow any prompts.

composer install --no-dev --optimize-autoloader

Clear Compiled Template Cache

You'll also want to clear the compiled template cache to ensure that new and modified templates show up correctly for users.

php artisan view:clear
php artisan config:clear

Database Updates

You'll also need to update your database schema for the newest version of Pterodactyl. Running the command below will update the schema and ensure the default eggs we ship are up to date (and add any new ones we might have). Just remember, never edit core eggs we ship! They will be overwritten by this update process.

php artisan migrate --seed --force

Set Permissions

The next step is to set the proper owner of the files to be the user that runs your webserver. In most cases this is www-data but can vary from system to system — sometimes being nginx, caddy, apache, or even nobody.

# If using NGINX or Apache (not on CentOS):
chown -R www-data:www-data /var/www/pterodactyl/*

# If using NGINX on CentOS:
chown -R nginx:nginx /var/www/pterodactyl/*

# If using Apache on CentOS
chown -R apache:apache /var/www/pterodactyl/*

Restarting Queue Workers

After every update you should restart the queue worker to ensure that the new code is loaded in and used.

php artisan queue:restart

Exit Maintenance Mode

Now that everything has been updated you need to exit maintenance mode so that the Panel can resume accepting connections.

php artisan up

Build the panel assets

export NODE_OPTIONS=--openssl-legacy-provider # for NodeJS v17+
yarn build:production # Build panel

Documentation

• Panel Documentation
• Wings Documentation
• Community Guides
• Or, get additional help via Discord

Sponsors

I would like to extend my sincere thanks to the following sponsors for helping fund Pterodactyl's development. Interested in becoming a sponsor?

Company	About
Aussie Server Hosts	No frills Australian Owned and operated High Performance Server hosting for some of the most demanding games serving Australia and New Zealand.
BisectHosting	BisectHosting provides Minecraft, Valheim and other server hosting services with the highest reliability and lightning fast support since 2012.
MineStrator	Looking for the most highend French hosting company for your minecraft server? More than 24,000 members on our discord trust us. Give us a try!
HostEZ	US & EU Rust & Minecraft Hosting. DDoS Protected bare metal, VPS and colocation with low latency, high uptime and maximum availability. EZ!
Blueprint	Create and install Pterodactyl addons and themes with the growing Blueprint framework - the package-manager for Pterodactyl. Use multiple modifications at once without worrying about conflicts and make use of the large extension ecosystem.
indifferent broccoli	indifferent broccoli is a game server hosting and rental company. With us, you get top-notch computer power for your gaming sessions. We destroy lag, latency, and complexity--letting you focus on the fun stuff.

Supported Games

Pterodactyl supports a wide variety of games by utilizing Docker containers to isolate each instance. This gives you the power to run game servers without bloating machines with a host of additional dependencies.

Some of our core supported games include:

• Minecraft — including Paper, Sponge, Bungeecord, Waterfall, and more
• Rust
• Terraria
• Teamspeak
• Mumble
• Team Fortress 2
• Counter Strike: Global Offensive
• Garry's Mod
• ARK: Survival Evolved

In addition to our standard nest of supported games, our community is constantly pushing the limits of this software and there are plenty more games available provided by the community. Some of these games include:

• Factorio
• San Andreas: MP
• Pocketmine MP
• Squad
• Xonotic
• Starmade
• Discord ATLBot, and most other Node.js/Python discord bots
• and many more...

License

Pterodactyl® Copyright © 2015 - 2022 Dane Everitt and contributors.

Code released under the MIT License.