Documentation

Dépannage

Le thème ne s'applique pas

  1. Vérifier que les fichiers sont là :

    ls -l /var/www/pterodactyl/public/theme
  2. Vérifier le lien dans le wrapper :

    grep -n "blhost" /var/www/pterodactyl/resources/views/templates/wrapper.blade.php
  3. Recharger sans cache : Ctrl+F5. Si un ?v= ancien est présent dans le wrapper, relancer sh install.sh (le script incrémente la version).

/auth/register renvoie 404

L'inscription est désactivée. Ouvrir Admin → Inscription et réactiver l'interrupteur, ou vérifier la valeur en base :

php artisan tinker --execute="echo \Pterodactyl\Services\Blhost\RegistrationSettings::enabled() ? 'on' : 'off';"

500 sur la page de connexion (reCAPTCHA)

Symptôme : POST /auth/login renvoie 500 quand g-recaptcha-response est absent. Voir le correctif.

La page admin renvoie 403

C'est normal sans session administrateur : les pages /admin/blhost/* sont derrière le middleware admin du panel. Se connecter avec un compte root_admin, ou vérifier :

php artisan route:list | grep blhost

Les entrées de la barre latérale admin n'apparaissent pas

Les addons ajoutent leurs entrées en clonant le lien Settings (/admin/settings) de la barre latérale. Si le panel change ce sélecteur, l'entrée peut manquer : les pages restent accessibles directement par leur URL (/admin/blhost/register, /admin/blhost/extras).

Le panel est injoignable en HTTPS

Vérifier les enregistrements DNS : un nom qui pointe vers deux adresses A provoque des erreurs TLS aléatoires (reset de connexion). Garder une seule adresse, celle du serveur du panel.

Les serveurs de jeu ne démarrent pas

Wings et Docker doivent être installés et enregistrés dans le panel. Sans eux, un serveur créé reste en erreur de connexion : ce n'est pas lié au thème ni aux addons.

Logs utiles

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

Les erreurs applicatives y sont horodatées en heure locale du serveur (Europe/Paris dans notre cas).

Repartir d'un état propre

cd /root/blhost-theme && sh install.sh --uninstall
cd addons/register && sh install.sh --uninstall
cd ../extras && sh install.sh --uninstall

Les sauvegardes restent dans /var/www/pterodactyl/storage/app/blhost-*-backup.