Installing Pterodactyl
To install it, we need dependencies:
PHP 8.0 or 8.1 (recommended) with the following extensions: cli, openssl, gd, mysql, PDO, mbstring, tokenizer, bcmath, xml, dom, curl, zip, (and fpm if you plan to use NGINX.)
MySQL 5.7.22 or higher (MySQL 8 recommended) or MariaDB 10.2 or higher.
Redis (redis-server) (Optional) (But this will make the panel run much faster under heavy loads).
Web server (Apache, NGINX)
curl
tar
unzip
git
composer v2
The example will use the ubuntu system
Adding repositories
apt -y install software-properties-common curl apt-transport-https ca-certificates gnupg
LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php
Install mariaDB
curl -sS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash
Next you need to update the repositories
apt update
Adding Universe Repositories
apt-add-repository universe
Now install all required dependencies
apt -y install php8.1 php8.1-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} mariadb-server apache2 tar unzip git (redis-server - Optional)
Since we will install the panel through composer, you need to install it
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer
Create a folder where the panel will be installed
mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl
Downloading the panel
curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz
Unpacking it
tar -xzvf panel.tar.gz
We issue the necessary rights to the folders.
chmod -R 755 storage/* bootstrap/cache
Next, you need to create a database
Go to mysql (When prompted, enter the password from root)
mysql -u root -p
Commands to be entered:
CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'yourPassword';
We create a user and instead of yourPassword enter the desired password (Save it, you will need it during setup).
Create the base itself (Instead of -panel, you can write another name)
CREATE DATABASE panel;
We issue the necessary rights to the user whom we created earlier.
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;
and exit mysql.
exit;
Next, we need to copy the configuration files for the panel to work.
cp .env.example .env
composer install --no-dev --optimize-autoloader (We agree here)
Create an application encryption key.
php artisan key:generate --force
The command with which we will configure the panel itself.
php artisan p:environment:setup
Here are the points where you need to properly configure.
This article will be the easiest setup.
Ask for mail first. (you can specify any) This mail will be used as the mail of the creator of standard eggs (egg - a list of games that are available for installation)
The second one will ask you to enter the address of the site that the panel will use, (http://yoursite.com) enter the domain that you purchased (Required in the form http://yoursite.com). (You can change it in the apache \ httpd configurations (further in the settings you will need to configure to write the same domain, but without http://)
Next will be the time zone (Indicate UTC) Or just press enter
The next one will ask for the cache driver (Choose Filesytem - it will be easier.) (file) The screenshot says redis, but it's better to choose File to make it easier to configure.
Select session driver Mysql. (database)
The queue driver (Queue driver) is also selected mysql. (database)
Next, they will offer a graphical parameter adjuster (here it’s just yes)
Now asks to send telemetry (Here at my discretion, but I put no)
Done, the panel setup is complete.
Сonnecting the database.
Now let's start connecting the database.
php artisan p:environment:database
The settings in this category are similar to the previous one.
1. Will query the database host. (Just press Enter if mysql is on the server itself)
2. Port (here, just like in the first paragraph, press enter)
3. Here you write down the name of the base that we created earlier and recorded the name in advance
4. Here we write down the user created in advance. (pterodactyl)
5. Create a password for the user.
This completes the installation of the panel.
The next step is to write the data to the database.
php artisan migrate --seed --force
If everything is configured correctly, there will be a large list of downloads to the database.
Now let's add a user.
php artisan p:user:make
The first will ask if this user is an administrator.
Write yes
Then he will ask for mail.
You can specify any.
Next, you need to enter the user's nickname (Any one will do - the main thing is to write it down somewhere, since it is needed to enter the panel)
The next item will ask you to enter your name. (any will do)
Last name (any name will do)
And the last item will require a password.
Any will do, but the main thing is to copy it to yourself somewhere.
Granting folder permissions
# When using Nginx or Apache:
chown -R www-data:www-data /var/www/pterodactyl/*
Create a cron run
Type crontab -e and add this line to the end.
* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1
Now let's add a service so that we can start the panel and add it to startup.
You need to create a pteroq.service file in the /etc/systemd/system folder
You need to add these lines to the file:
::
::
# Pterodactyl Queue Worker File
# ----------------------------------
[unit]
Description=Pterodactyl Queue Worker
After=redis-server.service
[service]
# On some systems the user and group might be different.
# Some systems use `apache` or `nginx` as the user and group.
User=www-data
Group=www-data
Restart=always
ExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
StartLimitInterval=180
StartLimit Burst=30
RestartSec=5s
[Install]
WantedBy=multi-user.target
::
::
Next, you need to create a pterodactyl.conf file in the /etc/apache2/sites-enabled (or conf.d) folder with the following lines.
::
::
<VirtualHost *:80>
ServerName Domain-that-was-created-previously-without-http://
DocumentRoot "/var/www/pterodactyl/public"
AllowEncodedSlashes On
php_value upload_max_filesize 100M
php_value post_max_size 100M
<Directory "/var/www/pterodactyl/public">
AllowOverride all
Require all granted
</Directory>
</VirtualHost>
::
::
Next you need to configure the Firewall
ufw allow http
ufw allow https
ufw reload
And you need to add a panel to autorun
systemctl enable --now pteroq.service
Ready. We installed the pterodactyl control panel.
The panel is available at your address: http://yoursite.com.