Skip to main content

Upgrading PHP

This documentation includes instructions for upgrading your system to the latest version of PHP. Please reference the table below to check what version you need for your version of Pterodactyl.

Panel VersionPHP Version
1.0.0 - 1.2.07.3, 7.4
1.3.0+7.4, 8.0
1.8.0+7.4, 8.0, 8.1
1.11.0+8.1

Install PHP​

In order to install PHP 8.1, you will need to run the following command. Please keep in mind different operating systems may have slightly different requirements for how this command is formatted.

# Add additional repository for PHP
add-apt-repository -y ppa:ondrej/php
apt -y update
apt -y install php8.1 php8.1-{cli,gd,mysql,pdo,mbstring,tokenizer,bcmath,xml,fpm,curl,zip}

Update Composer​

As of Panel@1.3.0 we require composer v2. To update composer you will need to run the following command which will perform the composer self-update process and move you over to version 2.

composer self-update --2

Webserver Configuration​

After upgrading to PHP 8.1, you will most likely need to update your NGINX configuration. Your configuration file is most likely called pterodactyl.conf and located in the /etc/nginx/sites-available/ directory, or if on CentOS, /etc/nginx/conf.d/.

Make sure to update the path in the command below to reflect the actual location of your configuration file.

sed -i -e 's/php[7|8].[0-9]-fpm.sock/php8.1-fpm.sock/' /etc/nginx/sites-available/pterodactyl.conf

Once you have edited the file run the command below to reload nginx and apply your changes.

systemctl reload nginx

Return to the 1.X.X Upgrade Guide​