Dépannage et FAQ technique

Toutes les commandes se lancent en root, depuis /var/www/velnex.

Où regarder

Système → Système, dans l’administration, vérifie aussi PHP, les dossiers, la base, le planificateur, la file d’attente, les e-mails, HTTPS et la licence. La fiche d’un service montre sa dernière erreur et son historique chez le fournisseur.

Erreur 502 Bad Gateway

PHP-FPM ne répond pas :

systemctl status php8.3-fpm
systemctl restart php8.3-fpm nginx

Erreur 500

tail -n 50 storage/logs/laravel.log

Causes fréquentes : droits sur les dossiers (chown -R www-data:www-data storage bootstrap/cache), base de données arrêtée (systemctl status mariadb), .env modifié par erreur. Après toute modification du .env : sudo -u www-data php artisan optimize:clear.

Erreur 419 « La session a expiré »

Le formulaire a été envoyé avec une session expirée : rechargez la page. Si l’erreur revient à chaque fois :

• APP_URL doit être exactement l’adresse utilisée, en https:// ;
• derrière Cloudflare, déclarez ses IP dans VEXORA_TRUSTED_PROXIES et utilisez le mode Full (strict), jamais « Flexible » (voir « Cloudflare et proxys ») ;
• vérifiez que l’horloge du serveur est à l’heure (timedatectl).

Services bloqués « Création en cours », e-mails qui ne partent pas

La file d’attente est arrêtée :

systemctl status velnex-queue
systemctl restart velnex-queue

Si les factures de renouvellement ne sont pas créées, vérifiez le planificateur : cat /etc/cron.d/velnex doit contenir la ligne schedule:run (voir « Tâches de fond »).

Service en « Échec de création »

Après 4 tentatives, Velnex arrête d’essayer et prévient l’équipe. Ouvrez la fiche du service : la dernière erreur indique la cause (clé API refusée, plus de place sur le serveur, plus d’adresse IP libre…). Corrigez, puis cliquez sur Créer maintenant. Voir aussi les guides « Connecter Proxmox VE », « Connecter Pterodactyl » et « Connecter Virtualizor ».

Paiement reçu, facture toujours « À payer »

Le webhook de la passerelle n’arrive pas ou est refusé : vérifiez son URL, ses événements et son secret (voir « Paiements Stripe et PayPal »). Dans l’intervalle, enregistrez le paiement avec Marquer comme payée.

Je n’ai plus accès à l’administration

• Mot de passe oublié : lien Mot de passe oublié sur /admin/login (les e-mails doivent fonctionner).
• Téléphone 2FA perdu : utilisez un code de récupération, ou demandez à un autre administrateur Réinitialiser la 2FA.
• Plus aucun compte utilisable : créez un super administrateur en ligne de commande :

sudo -u www-data php artisan vexora:admin

Page « Service momentanément indisponible »

Vos visiteurs voient cette page quand la licence n’est plus valide (expirée, suspendue, domaine différent…) ; l’administration vous redirige alors vers Système → Licence, qui en donne la raison. Vérifiez la licence en ligne de commande :

sudo -u www-data php artisan vexora:license

Elle affiche le statut, le palier, le nombre de clients et la date d’expiration. Si le serveur de licences est injoignable, votre site reste fonctionnel 3 jours : vérifiez que le serveur peut sortir en HTTPS. Les paiements reçus sont toujours enregistrés.

Les nouvelles inscriptions sont refusées

Vous avez atteint le nombre de clients actifs de votre palier : le site et les clients existants continuent de fonctionner, seules les nouvelles inscriptions sont bloquées. Passez au palier supérieur depuis votre espace client Velnex (Changer d’offre sur la licence), puis Système → Licence → Vérifier maintenant. Vérifiez aussi que Inscriptions clients ouvertes est coché dans Système → Paramètres → Sécurité.

Toujours bloqué ? Ouvrez un ticket depuis votre espace client, avec l’erreur et les dernières lignes du journal.