Upgrading PHP
Upgrade PHP to the latest version for your Pterodactyl Panel
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 Version | PHP Version |
|---|---|
| 1.0.0 - 1.2.0 | 7.3, 7.4 |
| 1.3.0+ | 7.4, 8.0 |
| 1.8.0+ | 7.4, 8.0, 8.1 |
| 1.11.0 - 1.11.3 | 8.0, 8.1 |
| 1.11.4+ | 8.1, 8.2, 8.3 |
| 1.11.10+ | 8.2, 8.3 |
Install PHP
In order to install PHP 8.3, 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.3 php8.3-{cli,gd,mysql,common,mbstring,tokenizer,bcmath,xml,fpm,curl,zip}Update Composer
As of [email protected] 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 --2Webserver Configuration
After upgrading to PHP 8.3, 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.3-fpm.sock/' /etc/nginx/sites-available/pterodactyl.confOnce you have edited the file run the command below to reload nginx and apply your changes.
systemctl reload nginxRun the commands below to disable all previous PHP versions and enable PHP 8.3 when serving requests.
# Hint: a2dismod = a2_disable_module
a2dismod php*
# Hint: a2enmod = a2_enable_module
a2enmod php8.3Return to the 1.X.X Upgrade Guide
After completing the PHP upgrade, return to the Panel upgrade guide to continue with the update process.