Installer Velnex en une commande · Centre d’aide

Connectez-vous au serveur en SSH, passez root, puis lancez :

bash <(curl -fsSL https://licenses.velnex.app/install.sh)

Les questions posées

Question	Réponse attendue
Nom de domaine du site	`billing.mon-hebergeur.fr` (sans `https://`)
Activer HTTPS avec Let’s Encrypt ?	`o` (conseillé)
E-mail pour Let’s Encrypt	votre adresse, pour les alertes d’expiration
Configurer le pare-feu UFW (SSH, HTTP, HTTPS) ?	`o`, sauf si vous gérez déjà un pare-feu
Lancer l’installation ?	`o` après avoir relu le récapitulatif

Ce que fait l’installateur

vérifie le système, la mémoire et que le domaine pointe bien vers ce serveur ;
installe Nginx, PHP 8.3 et MariaDB (accessible uniquement en local) ;
crée la base velnex et son utilisateur, avec un mot de passe aléatoire ;
télécharge la dernière version de Velnex et vérifie sa signature avant de l’installer dans /var/www/velnex ;
configure le site Nginx et, si demandé, le certificat Let’s Encrypt (renouvelé automatiquement) ;
installe les tâches de fond : le planificateur (/etc/cron.d/velnex, chaque minute), la file d’attente (service velnex-queue) et le relais de la console web des VPS (service velnex-console) — voir « Tâches de fond » ;
ouvre SSH, HTTP et HTTPS dans le pare-feu UFW, si demandé.

À la fin

L’installateur affiche l’adresse de l’assistant et les informations qu’il vous demandera :

✔ Le serveur est prêt.

Allez sur https://billing.mon-hebergeur.fr/install
pour terminer : licence, base de données et compte administrateur.

L'assistant vous demandera :
  Clé d'installation : XXXXXXXX-XXXXXXXX-XXXXXXXX
  Base de données    : velnex   Hôte : 127.0.0.1   Port : 3306
  Utilisateur        : velnex
  Mot de passe       : ••••••••

Ces informations sont aussi enregistrées dans /root/velnex-install.txt (lisible par root uniquement) : supprimez ce fichier une fois l’installation terminée. Continuez avec « L’assistant d’installation ».

Installation sans questions

Toutes les réponses peuvent être passées en variables d’environnement :

VELNEX_DOMAIN=billing.mon-hebergeur.fr \
[email protected] \
VELNEX_SSL=y VELNEX_FIREWALL=y VELNEX_YES=1 \
bash <(curl -fsSL https://licenses.velnex.app/install.sh)

Variable	Rôle
`VELNEX_DOMAIN`	nom de domaine du site
`VELNEX_EMAIL`	e-mail pour Let’s Encrypt
`VELNEX_SSL`	`y` ou `n` : HTTPS avec Let’s Encrypt
`VELNEX_FIREWALL`	`y` ou `n` : configurer UFW
`VELNEX_YES`	`1` : pas de confirmation finale
`VELNEX_DIR`	dossier d’installation (par défaut `/var/www/velnex`)

En cas d’erreur

Tout le déroulement est enregistré dans /var/log/velnex-install.log :

tail -n 50 /var/log/velnex-install.log

Les causes les plus fréquentes : le domaine ne pointe pas (encore) vers le serveur, un autre serveur web occupe le port 80, ou le système n’est pas pris en charge. L’installateur refuse de se relancer sur un serveur où Velnex est déjà installé : les mises à jour se font ensuite depuis l’administration.

Désinstaller

Pour tout retirer (après une sauvegarde finale et une confirmation par le nom de domaine) :

bash <(curl -fsSL https://licenses.velnex.app/uninstall.sh)

Voir « Désinstaller Velnex » pour le détail et les options (--dry-run pour simuler).