Manual Installation
Nova can be installed in two different ways: patch-based and manually. This page documents the manual installation method.
Manual installation may be simpler, however it will override almost all changes that you may have applied to Pterodactyl.
Remember that Nova edits a lot of the panel files, and as such is likely incompatible with any changes that you may have made to the panel beforehand, including other addons.
Put the panel into maintenance mode
Start off by putting the panel into maintenance mode:
php artisan down
This will prevent anyone from using the panel, so that you can install Nova without other worries.
Install Node.js
If you're using Debian-based or Ubuntu-based distributions, run the following commands:
curl -fsSL https://deb.nodesource.com/setup_lts.x | bash -
apt-get install -y nodejs
corepack enable
On other distributions, install Node.js using the distribution's package manager.
Copy Nova files
Using an SFTP client of your choice, upload all of the files from the PanelFiles
folder into your Pterodactyl folder.
Once that's done, copy the version.data
file to the public/nova
folder. This file is used by the version checker and should not be modified.
Install Composer dependencies
Nova includes new PHP dependencies. Install the new dependencies with the following command:
composer install --no-dev --optimize-autoloader
Build panel assets
Migrate the database, and set up a link to the public storage:
php artisan migrate
php artisan storage:link
The public storage is used by the avatar system in order to easily serve user-provided avatars.
Now, it's time to clean caches, download Node dependencies, and build the panel assets:
php artisan route:clear
php artisan view:clear
yarn install
NODE_OPTIONS=--openssl-legacy-provider yarn build:production
Set permissions
Web servers need to access the panel files in order to serve them. If you're using Debian or its derivatives, you can simply run the following command:
chown -R www-data:www-data /var/www/pterodactyl/*
This will change the ownership of the panel to the www-data
user. If you're using other distributions, the user may be different. For example, CentOS and Arch Linux are likely going to use the nginx
user instead.
Bring the panel back up
Congratulations, you have successfully installed Nova! You can now deactivate maintenance mode by running the following command:
php artisan up
And you should be all set!
Remember, if you have any issues with Nova, feel free to reach out to us over Discord.