NEW Evolve Panel is now live
← DocumentationEVOLVE PANEL

Install Evolve Panel

Use the installer from the Evolve Panel project directory, restart the web stack and queue worker, then apply the roles and Discord hotfix.

Before you begin

Run the commands as a user with sudo access. Back up the panel database, .env file and storage data before upgrading an existing installation.

1. Open the project directory

The expected installation directory is:

Terminal
cd /var/www/EvolvePanel

2. Run the installer

Start the included Evolve Panel installation or update script:

Terminal
bash install.sh

3. Restart PHP-FPM and Nginx

Reload the PHP 8.3 application worker and web server after the installer completes:

Terminal
sudo systemctl restart php8.3-fpm
sudo systemctl restart nginx

4. Restart the queue worker

The command first attempts the Evolve Panel queue service and falls back to the standard Pterodactyl queue service when required:

Terminal
sudo systemctl restart evhpanel-queue 2>/dev/null || sudo systemctl restart pteroq

5. Apply the roles and Discord hotfix

Run the supplied repair script after the installation is complete:

Terminal
bash apply-roles-discord-hotfix.sh

Complete command sequence

Copy all
cd /var/www/EvolvePanel
bash install.sh
sudo systemctl restart php8.3-fpm
sudo systemctl restart nginx
sudo systemctl restart evhpanel-queue 2>/dev/null || sudo systemctl restart pteroq
bash apply-roles-discord-hotfix.sh

Verify the services

Terminal
sudo systemctl status php8.3-fpm --no-pager
sudo systemctl status nginx --no-pager
sudo systemctl status evhpanel-queue --no-pager 2>/dev/null || sudo systemctl status pteroq --no-pager

Open the panel and test login, server access, roles and Discord integration. Review the Nginx and Laravel logs if a page returns an error.

Next guide

Install a licensed FiveM script

Continue