Tâches de fond : planificateur, file d’attente et console

Le cron et les services velnex-queue et velnex-console, et comment les vérifier.

Mis à jour le 1 octobre 2026

Sur cette page

Velnex a besoin de trois processus en plus du site web. L’installateur les met en place ; cet article explique leur rôle et comment les vérifier.

Processus Rôle Sans lui
Planificateur (/etc/cron.d/velnex) facturation quotidienne, vérification de la licence, recherche de mises à jour, RGPD pas de factures de renouvellement, de rappels ni de suspensions
File d’attente (velnex-queue) envoi des e-mails, création des services chez les fournisseurs, réinstallations, exports e-mails qui ne partent pas, services bloqués « Création en cours »
Relais de console (velnex-console) console web des VPS Proxmox la console ne s’ouvre pas (le reste fonctionne)

Système → Système vérifie le planificateur et la file d’attente (avec la ligne cron à copier si elle manque), et Système → Automatisation montre les derniers passages de la facturation.

Le planificateur

Le fichier /etc/cron.d/velnex lance Velnex chaque minute :

* * * * * www-data cd /var/www/velnex && php artisan schedule:run >> /dev/null 2>&1
Tâche Fréquence
Facturation (vexora:billing) : renouvellements, rappels, suspensions, résiliations, commandes impayées, fermeture des tickets chaque jour à 3 h
Recherche de mise à jour (vexora:check-updates) chaque jour à 4 h 20
Vérification de la licence (vexora:license) toutes les 6 heures
Exports et suppressions de comptes (vexora:privacy) chaque heure
Nettoyage du journal d’activité (plus d’un an) chaque jour

Vérifier et lancer à la main :

cat /etc/cron.d/velnex
systemctl status cron
cd /var/www/velnex && sudo -u www-data php artisan schedule:list
sudo -u www-data php artisan vexora:billing

La file d’attente

Le service velnex-queue exécute les tâches en arrière-plan (php artisan queue:work), redémarre tout seul en cas d’arrêt et se recycle toutes les heures :

systemctl status velnex-queue
journalctl -u velnex-queue -n 100
systemctl restart velnex-queue

Une création de service qui échoue est retentée 4 fois (après 1, 5 puis 15 minutes) avant de passer en « Échec de création » ; l’équipe est alors prévenue par e-mail.

Le relais de console

Le service velnex-console (php artisan vexora:console-relay, sur 127.0.0.1:8090) relaie la console web des VPS, publiée par Nginx sur /console-ws. Voir « Connecter Proxmox VE ».

systemctl status velnex-console
systemctl restart velnex-console

Après chaque mise à jour de Velnex : systemctl restart velnex-queue velnex-console.

Commandes utiles

Toutes se lancent depuis /var/www/velnex, avec sudo -u www-data php artisan … :

Commande Rôle
vexora:license vérifie la licence maintenant et affiche son état
vexora:check-updates cherche une nouvelle version
vexora:billing lance la facturation quotidienne
vexora:admin crée un compte super administrateur
vexora:permissions resynchronise les permissions et les rôles par défaut
vexora:install-key affiche la clé demandée par l’assistant /install
optimize:clear vide les caches (après une modification du .env)

Cet article n’a pas résolu votre problème ?

Ouvrir un ticket