Pterodactyl Panel: kompletná inštalácia na vlastný VPS

Nainštalujeme Pterodactyl Panel, webové rozhranie na správu herných serverov, na váš VPS. Na konci pobeží na adrese https://panel.example.cz s certifikátom Let's Encrypt, frontou úloh, cronom a vaším administrátorským účtom.

Ako to funguje#

Pterodactyl má dve časti. Panel je webová aplikácia (PHP, framework Laravel), v ktorej zakladáte používateľov a servery a kde hráči ovládajú konzolu. Wings je služba, ktorá na serveri skutočne spúšťa herné servery v kontajneroch Dockeru. Panel aj Wings môžu bežať na rovnakom VPS. Tento návod inštaluje Panel, Wings pridáte v nadväzujúcom návode Pterodactyl Wings.

Panel potrebuje niekoľko ďalších programov:

Panel samotný je nenáročný. Ak na rovnakom VPS pobežia aj herné servery, plánujte RAM hlavne podľa nich a pripočítajte rezervu pre systém, databázu a Panel (orientačne 1–⁠2 GB).

Plán inštalácie#

Doména a DNS#

Panel potrebuje vlastnú doménu alebo subdoménu. Certifikát pre HTTPS sa vydáva na doménu, nie na IP adresu.

1. V zákazníckom účte otvorte Moje služby, kliknite na VPS a v záložke Sieť skopírujte IPv4 adresu (a prípadne IPv6 adresu).

2. U svojho DNS hostingu vytvorte záznam typu A pre panel.example.cz s hodnotou IPv4 adresy VPS (napríklad 203.0.113.10).

3. Voliteľne vytvorte aj záznam AAAA s IPv6 adresou VPS (napríklad 2001:db8::10). Konfigurácia Nginx nižšie počúva aj na IPv6.

4. Na VPS overte, že doména už ukazuje správne:

   getent hosts panel.example.cz

   • getent hosts – opýta sa systémového DNS na adresu domény a vypíše ju.

   Uvidíte riadok s IP adresou vášho VPS. Keď sa nič nevypíše, počkajte pár minút (podľa TTL záznamu) a skúste to znova.

Firewall#

Prehliadač sa k Panelu pripojí na port 443 (HTTPS). Port 80 (HTTP) je potrebný na overenie domény pri vydaní certifikátu a na presmerovanie na HTTPS.

• Firewall v zákazníckom účte: ak máte prichádzajúcu prevádzku v režime Blokovať všetko okrem povoleného, pridajte pravidlá Prichádzajúce · Povoliť · TCP · port 80,443. Pravidlo pre SSH (port 22) musí zostať. Návod: Firewall v zákazníckom účte.

• UFW vo VPS: ak ho používate, povoľte porty aj v ňom:

  ufw allow 80/tcp
  ufw allow 443/tcp

  • ufw allow 80/tcp – povolí prichádzajúce TCP spojenia na port 80.
  • ufw allow 443/tcp – to isté pre port 443.

Porty pre Wings (8080 a 2022) a pre herné servery otvoríte až v návode Pterodactyl Wings.

Inštalácia závislostí#

Najprv aktualizujte systém, aby ste inštalovali na aktuálny základ:

apt update && apt -y upgrade

• apt update – stiahne aktuálny zoznam balíkov.
• apt -y upgrade – nainštaluje dostupné aktualizácie; -y odpovie „áno“ na potvrdenie.

Potom nainštalujte závislosti. Postup sa líši podľa systému: Ubuntu 24.04 má PHP 8.3 priamo v repozitári, Debian 13 má v predvolenom repozitári PHP 8.4, ktoré Panel nepodporuje (aktuálny Panel vyžaduje PHP 8.2 alebo 8.3). Na Debiane preto pridáte repozitár packages.sury.org, ktorý odporúča aj oficiálna dokumentácia Pterodactylu.

Čo inštalačný príkaz obsahuje:

Overte, že máte správnu verziu PHP:

php -v

PHP 8.3.x (cli) …

Na prvom riadku musí byť PHP 8.3. Ak vidíte PHP 8.4, pozrite sa do časti Keď niečo nefunguje.

Skontrolujte, že bežia služby:

systemctl is-active mariadb redis-server nginx php8.3-fpm

• systemctl is-active – vypíše stav každej uvedenej služby.

Uvidíte štyrikrát active. Ak je niektorá inactive, spustite ju a zapnite po štarte príkazom systemctl enable --now <NAZEV_SLUZBY>, napríklad systemctl enable --now redis-server.

Composer#

Composer stiahne PHP knižnice Panelu. Nainštalujte ho oficiálnym inštalátorom:

curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

• curl -sS https://getcomposer.org/installer – stiahne inštalačný skript Composeru.
• | php -- – odovzdá skript PHP na spustenie; -- oddeľuje parametre PHP od parametrov inštalátora.
• --install-dir=/usr/local/bin – kam sa Composer nainštaluje (priečinok, v ktorom systém hľadá programy).
• --filename=composer – názov programu, takže ho potom spustíte príkazom composer.

Overenie: composer --version vypíše Composer version 2.…. Ako root uvidíte aj varovanie Do not run Composer as root/super user! a možno otázku Continue as root/super user [yes]?. Potvrďte ju klávesom Enter. Pri inštalácii Panelu nižšie varovanie potlačí premenná COMPOSER_ALLOW_SUPERUSER=1.

Stiahnutie Panelu#

1. Vytvorte priečinok pre Panel a prejdite doň:

   mkdir -p /var/www/pterodactyl
   cd /var/www/pterodactyl

   • mkdir -p – vytvorí priečinok (aj s nadradenými); keď už existuje, nevypíše chybu.
   • cd – prepne do priečinka. Všetky ďalšie príkazy php artisan spúšťajte v ňom.

2. Stiahnite a rozbaľte najnovšiu verziu Panelu:

   curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz
   tar -xzvf panel.tar.gz

   • curl -Lo panel.tar.gz … – stiahne archív najnovšieho vydania z GitHubu a uloží ho ako panel.tar.gz.
   • tar -xzvf – rozbalí archív (x rozbaliť, z formát gzip, v vypisovať súbory, f zo súboru).

3. Nastavte práva priečinkov, do ktorých Panel zapisuje:

   chmod -R 755 storage/* bootstrap/cache/

   • chmod -R 755 – vlastník smie čítať, zapisovať a vstupovať do priečinkov, ostatní iba čítať a vstupovať. -R platí pre celý obsah.
   • storage/ – logy, cache a nahrané súbory; bootstrap/cache/ – skompilovaná konfigurácia.

Databáza pre Panel#

Panel potrebuje vlastnú databázu a vlastného používateľa. Databázového používateľa root autori Pterodactylu pre Panel výslovne zakazujú: keby niekto Panel napadol, získal by prístup ku všetkým databázam na VPS.

1. Vygenerujte si silné heslo pre databázového používateľa, napríklad v generátore hesiel. Použite iba písmená a číslice (aspoň 24 znakov), aby ste nemuseli riešiť špeciálne znaky v SQL a v .env. Heslo si uložte, budete ho o chvíľu zadávať znova.

2. Prihláste sa do MariaDB ako správca:

   mariadb

   • mariadb – klient databázy. Používateľ root systému sa na Ubuntu aj Debiane prihlási do MariaDB bez hesla (overením cez unix socket). Uvidíte výzvu MariaDB [(none)]>.

3. Vytvorte používateľa a databázu. Za <HESLO_DB_PANELU> dosaďte heslo z kroku 1 (apostrofy okolo hesla ponechajte):

   CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY '<HESLO_DB_PANELU>';
   CREATE DATABASE panel;
   GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1';
   exit

Konfigurácia prostredia (.env)#

Nastavenie Panelu je v súbore /var/www/pterodactyl/.env. Vytvoríte ho z predlohy, nainštalujete knižnice a vygenerujete šifrovací kľúč.

1. Skopírujte predlohu:

   cp .env.example .env

2. Nainštalujte PHP knižnice Panelu:

   COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader

   • COMPOSER_ALLOW_SUPERUSER=1 – povolí spustenie Composeru ako root bez otázky.
   • composer install – stiahne knižnice presne vo verziách, ktoré určuje Panel (súbor composer.lock).
   • --no-dev – vynechá nástroje pre vývojárov, na produkčnom serveri ich nepotrebujete.
   • --optimize-autoloader – pripraví rýchlejšie načítanie tried PHP.

   Inštalácia trvá jednotky minút a končí bez chybových hlásení (žlté varovanie o zastaraných balíčkoch neprekáža).

3. Vygenerujte šifrovací kľúč:

   php artisan key:generate --force

   • php artisan – nástroj Panelu na správu z príkazového riadka.
   • key:generate – vytvorí náhodný kľúč APP_KEY a zapíše ho do .env.
   • --force – vykoná príkaz bez potvrdenia (Panel beží v produkčnom režime, kde sa inak pýta).

4. Zobrazte kľúč a uložte si celý riadok mimo servera (do správcu hesiel alebo šifrovaného súboru v počítači):

   grep APP_KEY /var/www/pterodactyl/.env

   APP_KEY=base64:…

Sprievodca p:environment:setup#

Základné nastavenie vykoná sprievodca. Spustite ho:

php artisan p:environment:setup

Postupne sa opýta na tieto veci (predvolená hodnota je v hranatých zátvorkách, potvrdíte ju klávesom Enter):

Keď zadáte adresu začínajúcu https://, sprievodca sám zapne bezpečné cookies (SESSION_SECURE_COOKIE=true).

Sprievodca p:environment:database#

php artisan p:environment:database

Sprievodca sa hneď skúsi pripojiť. Keď údaje nesedia, vypíše Unable to connect to the MySQL server…, nič neuloží a opýta sa, či to chcete skúsiť znova.

Sprievodca p:environment:mail#

Panel posiela e-maily (pozvánky nových používateľov, obnovenie hesla). Bez nastavenej pošty Panel funguje, iba tieto e-maily neodídu. Nastavenie môžete urobiť aj neskôr, rovnakým príkazom:

php artisan p:environment:mail

Dôležité kľúče v .env#

Sprievodcovia zapisujú do .env tieto hodnoty. Súbor môžete upraviť aj ručne (nano /var/www/pterodactyl/.env); po ručnej úprave spustite php artisan config:clear.

Tabuľky v databáze a prvý administrátor#

1. Vytvorte tabuľky a nahrajte predvolené dáta:

   php artisan migrate --seed --force

   • migrate – vytvorí v databáze panel všetky tabuľky.
   • --seed – naplní ich predvolenými dátami, okrem iného šablónami hier (Minecraft, Rust a ďalšie).
   • --force – spustí príkaz bez potvrdenia v produkčnom režime.

   Príkaz môže bežať aj niekoľko minút. Neprerušujte ho, inak zostane databáza napoly vytvorená.

2. Vytvorte administrátorský účet:

   php artisan p:user:make

Na konci uvidíte tabuľku s údajmi účtu a riadkom Admin | Yes.

Oprávnenia súborov#

Súbory Panelu teraz patria používateľovi root. Webový server beží ako používateľ www-data a musí do priečinkov storage a bootstrap/cache zapisovať:

chown -R www-data:www-data /var/www/pterodactyl/*

• chown -R – zmení vlastníka súborov aj celého obsahu priečinkov.
• www-data:www-data – používateľ a skupina, pod ktorými na Ubuntu a Debiane beží Nginx a PHP-FPM.

Cron a fronta úloh#

Cron#

Cron spúšťa plánovač Panelu každú minútu (mazanie starých prihlásení, plánované úlohy serverov).

1. Otvorte crontab používateľa root:

   crontab -e

   Pri prvom spustení sa opýta na editor. Zvoľte nano (napíšte jeho číslo a stlačte Enter). Ak systém hlási crontab: command not found, cron chýba. Nainštalujte ho príkazom apt -y install cron a krok zopakujte.

2. Na koniec súboru vložte riadok:

   * * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1

3. Uložte (Ctrl+O, Enter) a zatvorte editor (Ctrl+X). Uvidíte crontab: installing new crontab.

Služba fronty pteroq#

Fronta spracúva prácu na pozadí: odosielanie e-mailov a úlohy, ktoré si používatelia naplánujú pri serveroch (sekcia Schedules, napríklad nočný reštart alebo záloha). Bez nej e-maily neodchádzajú a naplánované úlohy sa nevykonajú.

1. Vytvorte súbor služby:

   nano /etc/systemd/system/pteroq.service

2. Vložte obsah:

   # Pterodactyl Queue Worker File
   [Unit]
   Description=Pterodactyl Queue Worker
   After=redis-server.service
   
   [Service]
   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
   StartLimitBurst=30
   RestartSec=5s
   
   [Install]
   WantedBy=multi-user.target

3. Uložte a zatvorte editor.

4. Zapnite Redis aj frontu po štarte a hneď ich spustite:

   systemctl enable --now redis-server
   systemctl enable --now pteroq.service

   • enable – zapne automatické spustenie po reštarte VPS.
   • --now – zároveň službu hneď spustí.

5. Skontrolujte stav:

   systemctl status pteroq

   Uvidíte Active: active (running). Výpis zavriete klávesom q.

Certifikát Let's Encrypt#

Konfigurácia Nginx nižšie odkazuje na súbory certifikátu. Nginx s ňou nenaštartuje, kým certifikát neexistuje, preto ho získate ako prvý.

1. Nainštalujte Certbot a jeho doplnok pre Nginx:

   apt -y install certbot python3-certbot-nginx

   • certbot – program, ktorý získava a obnovuje certifikáty Let's Encrypt.
   • python3-certbot-nginx – doplnok, ktorý overí doménu cez bežiaci Nginx bez jeho vypnutia.

2. Získajte certifikát. Za panel.example.cz dosaďte svoju doménu:

   certbot certonly --nginx -d panel.example.cz

   • certonly – iba získa certifikát a uloží ho, konfiguráciu Nginx neupravuje (tú napíšete sami).
   • --nginx – overenie domény prebehne cez Nginx na porte 80.
   • -d panel.example.cz – doména, pre ktorú certifikát chcete.

3. Pri prvom spustení odpovedzte na otázky:

   • E-mail (Enter email address…) – zadajte svoj e-mail. Let's Encrypt naň posiela dôležité oznámenia o účte. Upozornenia na vypršanie certifikátu od roku 2025 neposiela, obnovu preto stráži automatika (pozri krok 5).
   • Podmienky služby (Please read the Terms of Service… Do you agree?) – odpovedzte Y, bez súhlasu certifikát nedostanete.
   • Zdieľanie e-mailu s EFF (Would you be willing… to share your email address with the Electronic Frontier Foundation…) – podľa vás, na vydanie certifikátu nemá vplyv.

   Na konci uvidíte Successfully received certificate. a cesty k súborom:

   Certificate is saved at: /etc/letsencrypt/live/panel.example.cz/fullchain.pem
   Key is saved at:         /etc/letsencrypt/live/panel.example.cz/privkey.pem

4. Nastavte, aby Nginx po každej obnove certifikátu načítal nový. Vytvorte takzvaný deploy hook (skript, ktorý Certbot spustí po úspešnej obnove):

   cat > /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh <<'EOF'
   #!/bin/sh
   systemctl reload nginx
   EOF
   chmod 755 /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh

   • cat > … <<'EOF' … EOF – zapíše riadky medzi <<'EOF' a EOF do súboru.
   • systemctl reload nginx – načíta novú konfiguráciu a certifikáty bez prerušenia spojení.
   • chmod 755 – urobí skript spustiteľným; Certbot spúšťa iba spustiteľné súbory v priečinku renewal-hooks/deploy.

5. Overte, že automatická obnova funguje. Balík Certbotu na Ubuntu aj Debiane obsahuje časovač, ktorý obnovu skúša dvakrát denne:

   systemctl list-timers | grep certbot
   certbot renew --dry-run

   • systemctl list-timers – vypíše naplánované časovače; medzi nimi má byť certbot.timer.
   • certbot renew --dry-run – vyskúša obnovu proti testovaciemu serveru Let's Encrypt, skutočný certifikát nemení.

   Test skončí hlásením Congratulations, all simulated renewals succeeded.

Certifikát platí 90 dní (stav k októbru 2026; Let's Encrypt platnosť postupne skracuje). Certbot ho obnovuje sám, keď zostáva zhruba tretina platnosti.

Nginx#

1. Vypnite predvolený web Nginxu:

   rm /etc/nginx/sites-enabled/default

   • Zmaže iba odkaz v sites-enabled, samotný súbor v sites-available zostane. Predvolený web by inak obsluhoval port 80 namiesto Panelu.

2. Vytvorte konfiguráciu Panelu:

   nano /etc/nginx/sites-available/pterodactyl.conf

3. Vložte obsah a všetky štyri výskyty panel.example.cz nahraďte svojou doménou:

   server {
       listen 80;
       listen [::]:80;
       server_name panel.example.cz;
       return 301 https://$server_name$request_uri;
   }
   
   server {
       listen 443 ssl http2;
       listen [::]:443 ssl http2;
       server_name panel.example.cz;
       server_tokens off;
   
       root /var/www/pterodactyl/public;
       index index.php;
   
       access_log /var/log/nginx/pterodactyl.app-access.log;
       error_log  /var/log/nginx/pterodactyl.app-error.log error;
   
       # väčšie nahrávané súbory a dlhší beh skriptov
       client_max_body_size 100m;
       client_body_timeout 120s;
   
       sendfile off;
   
       ssl_certificate /etc/letsencrypt/live/panel.example.cz/fullchain.pem;
       ssl_certificate_key /etc/letsencrypt/live/panel.example.cz/privkey.pem;
       ssl_session_cache shared:SSL:10m;
       ssl_protocols TLSv1.2 TLSv1.3;
       ssl_ciphers "ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384";
       ssl_prefer_server_ciphers on;
   
       add_header X-Content-Type-Options nosniff;
       add_header X-XSS-Protection "1; mode=block";
       add_header X-Robots-Tag none;
       add_header Content-Security-Policy "frame-ancestors 'self'";
       add_header X-Frame-Options DENY;
       add_header Referrer-Policy same-origin;
   
       location / {
           try_files $uri $uri/ /index.php?$query_string;
       }
   
       location ~ \.php$ {
           fastcgi_split_path_info ^(.+\.php)(/.+)$;
           fastcgi_pass unix:/run/php/php8.3-fpm.sock;
           fastcgi_index index.php;
           include fastcgi_params;
           fastcgi_param PHP_VALUE "upload_max_filesize = 100M \n post_max_size=100M";
           fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
           fastcgi_param HTTP_PROXY "";
           fastcgi_intercept_errors off;
           fastcgi_buffer_size 16k;
           fastcgi_buffers 4 16k;
           fastcgi_connect_timeout 300;
           fastcgi_send_timeout 300;
           fastcgi_read_timeout 300;
       }
   
       location ~ /\.ht {
           deny all;
       }
   }

Konfigurácia vychádza z oficiálnej dokumentácie Pterodactylu. Doplnili sme počúvanie na IPv6 (listen [::]:…) a skrytie verzie Nginxu. Čo jednotlivé časti robia:

4. Zapnite konfiguráciu, otestujte ju a reštartujte Nginx:

   ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/pterodactyl.conf
   nginx -t
   systemctl restart nginx

   • ln -s – vytvorí v sites-enabled odkaz na súbor; Nginx načítava iba konfigurácie v sites-enabled.
   • nginx -t – skontroluje syntax. Musí skončiť riadkom test is successful. Ak nie, Nginx nereštartujte a opravte riadok, ktorý chyba uvádza.
   • systemctl restart nginx – načíta novú konfiguráciu.

Prvé prihlásenie#

1. V prehliadači otvorte https://panel.example.cz. Uvidíte prihlasovaciu stránku Panelu so zámkom (platný certifikát) v adresnom riadku.
2. Prihláste sa menom alebo e-mailom a heslom administrátora.
3. Vpravo hore kliknite na ikonu ozubeného kolesa (administrácia). V sekcii Settings nastavte názov Panelu (Company Name).
4. Zapnite si dvojfázové overenie: kliknite na svoj účet vpravo hore, otvorte Account a v časti dvojfázového overenia naskenujte QR kód aplikáciou (napríklad Google Authenticator alebo Aegis). Účet administrátora ovláda všetky servery, preto ho chráňte viac než heslom.

Overenie#

Skontrolujte celú inštaláciu:

systemctl is-active nginx php8.3-fpm mariadb redis-server pteroq
curl -sI https://panel.example.cz | head -n 1

• Prvý príkaz musí vypísať päťkrát active.
• curl -sI stiahne iba hlavičky odpovede; prvý riadok bude HTTP/2 302 (presmerovanie na prihlásenie) alebo HTTP/2 200.

Panel je hotový. Ďalší krok je pridať nod so službou Wings, na ktorom pobežia herné servery: Pterodactyl Wings.

Panel za Cloudflare#

Panel môžete schovať za proxy Cloudflare (oranžový obláčik). Platí to iba pre Panel, nie pre Wings (pozri Pterodactyl Wings).

1. V Cloudflare nastavte režim SSL/TLS na Full (strict). Cloudflare sa potom k VPS pripája cez HTTPS a overuje váš certifikát Let's Encrypt.

2. Prepnite záznam panel.example.cz na Proxied.

3. Do .env doplňte na jeden riadok rozsahy IP adries Cloudflare. Za proxy sa k Panelu všetky požiadavky pripájajú z adries Cloudflare. Panel potom skutočnú IP adresu návštevníka prevezme z hlavičky X-Forwarded-For, ale iba od adries, ktorým verí. Bez tohto riadka by Panel pri všetkých používateľoch videl iba adresy Cloudflare, a to v záznamoch aktivít aj v ochrane proti skúšaniu hesiel, ktorá počíta pokusy podľa IP adresy. Zoznam nižšie zodpovedá stavu k 1. 10. 2026, aktuálny nájdete na stránke cloudflare.com/ips (otvorí sa v novom okne):

   TRUSTED_PROXIES=173.245.48.0/20,103.21.244.0/22,103.22.200.0/22,103.31.4.0/22,141.101.64.0/18,108.162.192.0/18,190.93.240.0/20,188.114.96.0/20,197.234.240.0/22,198.41.128.0/17,162.158.0.0/15,104.16.0.0/13,104.24.0.0/14,172.64.0.0/13,131.0.72.0/22,2400:cb00::/32,2606:4700::/32,2803:f800::/32,2405:b500::/32,2405:8100::/32,2a06:98c0::/29,2c0f:f248::/32

   • TRUSTED_PROXIES – zoznam adries a rozsahov (oddelených čiarkou bez medzier), od ktorých Panel prijme hlavičky X-Forwarded-* so skutočnou IP adresou návštevníka a protokolom. Od iných adries tieto hlavičky ignoruje, takže si ich nikto nemôže podvrhnúť.

4. Načítajte novú konfiguráciu: cd /var/www/pterodactyl && php artisan config:clear.

Aktualizácia Panelu#

Nové verzie Panelu opravujú chyby aj bezpečnostné diery, aktualizujte preto pravidelne. Pred aktualizáciou si prečítajte poznámky k vydaniu na GitHube a skontrolujte, akú verziu PHP nová verzia vyžaduje (php -v).

• mariadb-dump --single-transaction panel – vyexportuje databázu panel do SQL súboru bez zamykania tabuliek.
• $(date +%F) – vloží dnešný dátum (napríklad 2026-10-01) do názvu súboru.

Potom vykonajte aktualizáciu:

cd /var/www/pterodactyl
php artisan down
curl -L https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz | tar -xzv
chmod -R 755 storage/* bootstrap/cache
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
php artisan view:clear
php artisan config:clear
php artisan migrate --seed --force
chown -R www-data:www-data /var/www/pterodactyl/*
php artisan queue:restart
php artisan up

Po aktualizácii Panelu aktualizujte aj Wings, postup je v návode Pterodactyl Wings. Verzie Panelu a Wings majú ísť ruka v ruke, používajte najnovšie vydanie oboch.

Zálohy Panelu#

Na obnovu Panelu potrebujete dve veci: databázu panel a súbor .env (hlavne APP_KEY). Dáta herných serverov ležia na node s Wings, nie v Paneli, zálohujte ich zvlášť. Ako zálohy automatizovať a dostať mimo servera, opisuje návod Zálohy na VPS.

Keď niečo nefunguje#

502 Bad Gateway#

Nginx sa nedostal k PHP-FPM. Skontrolujte, že PHP-FPM beží a že cesta k socketu sedí:

systemctl status php8.3-fpm
ls /run/php/

Vo výpise ls musí byť php8.3-fpm.sock a rovnaká cesta musí byť v direktíve fastcgi_pass. Ak služba nebeží, spustite ju: systemctl enable --now php8.3-fpm.

Chyba 500 alebo prázdna stránka#

Pozrite sa do logu Panelu:

tail -n 100 /var/www/pterodactyl/storage/logs/laravel-$(date +%F).log

• tail -n 100 – vypíše posledných 100 riadkov logu z dnešného dňa.

Hľadajte riadok s dátumom a slovom ERROR. Najčastejšie príčiny:

• Permission denied – nesprávny vlastník súborov. Spustite znova chown -R www-data:www-data /var/www/pterodactyl/*.
• No application encryption key has been specified. – chýba APP_KEY. Pri prvej inštalácii spustite php artisan key:generate --force. Ak Panel už dáta má, vráťte pôvodný kľúč zo zálohy.
• SQLSTATE[HY000] [1045] Access denied – nesedí heslo alebo používateľ databázy v .env.

The MAC is invalid#

Databáza bola zašifrovaná iným APP_KEY, než je teraz v .env. Typicky po obnove databázy na novú inštaláciu. Jediná oprava je vrátiť do .env pôvodný APP_KEY. Bez neho sa šifrované dáta obnoviť nedajú.

E-maily nechodia#

Najčastejšie nebeží fronta. Skontrolujte službu a jej log:

systemctl status pteroq
journalctl -u pteroq -n 50

• journalctl -u pteroq -n 50 – posledných 50 riadkov logu služby.

Overte tiež, že beží Redis (systemctl status redis-server). Po oprave spustite systemctl restart pteroq. Ak fronta beží, skontrolujte nastavenie pošty (php artisan p:environment:mail) a chyby v logu Panelu (kapitola Chyba 500).

Server visí na inštalácii#

Inštaláciu servera vykonáva Wings, nie Panel. Postup je v návode Pterodactyl Wings v časti „Keď niečo nefunguje“ (najčastejšie nefunkčné DNS v kontajneroch alebo nedostupný nod).

Naplánované úlohy serverov sa nespúšťajú#

Skontrolujte, že beží fronta (systemctl status pteroq), riadok v crone (crontab -l) a časové pásma: systém (timedatectl), Panel (APP_TIMEZONE v .env). Pomôže aj vymazanie cache plánovača:

php /var/www/pterodactyl/artisan schedule:clear-cache
systemctl restart pteroq

Nginx nenaštartuje: cannot load certificate#

Certifikát pre doménu v konfigurácii neexistuje: nezískali ste ho, alebo sa doména v server_name a v ceste /etc/letsencrypt/live/… líši od tej, pre ktorú bol vydaný. Zoznam certifikátov vypíše certbot certificates.

Certbot: Timeout during connect (likely firewall problem)#

Let's Encrypt sa nedostal na port 80 vášho VPS. Skontrolujte, že A záznam domény ukazuje na IPv4 adresu VPS, že je port 80 povolený vo firewalle zákazníckeho účtu aj v UFW a že Nginx beží. Ak má doména záznam AAAA, musí ukazovať na IPv6 adresu tohto VPS, Let's Encrypt skúša aj IPv6.

Composer alebo artisan hlási nesprávnu verziu PHP#

Hlásenie obsahuje napríklad requires php ^8.2 || ^8.3 but your php version (8.4…) does not satisfy that requirement. Príkaz php spúšťa inú verziu než 8.3, typicky na Debiane 13 po inštalácii predvoleného balíka php. Nastavte predvolené PHP na 8.3:

update-alternatives --set php /usr/bin/php8.3
php -v

• update-alternatives --set php … – určí, ktorú verziu spúšťa príkaz php.

Ak /usr/bin/php8.3 neexistuje, PHP 8.3 nie je nainštalované. Vráťte sa ku kapitole Inštalácia závislostí.

Stránka sa za Cloudflare točí v presmerovaní (ERR_TOO_MANY_REDIRECTS)#

V Cloudflare je režim Flexible. Prepnite ho na Full (strict) a skontrolujte aj TRUSTED_PROXIES podľa Panel za Cloudflare.

Za Cloudflare nefunguje konzola serverov#

Doména nodu ide cez proxy Cloudflare (oranžový obláčik). Typicky keď nod používa rovnakú doménu ako Panel. Prepnite doménu nodu na DNS only, alebo nodu dajte samostatnú subdoménu.

Ďalšie zdroje#

• Pterodactyl: Getting Started (otvorí sa v novom okne)
• Pterodactyl: Webserver Configuration (otvorí sa v novom okne)
• Pterodactyl: Updating the Panel (otvorí sa v novom okne)
• Pterodactyl: Additional Configuration (otvorí sa v novom okne)
• Pterodactyl: Troubleshooting (otvorí sa v novom okne)
• Certbot: User Guide (otvorí sa v novom okne)