Désinstaller Velnex · Centre d’aide

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

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

Le désinstallateur détecte les installations Velnex du serveur (domaine, dossier, base de données) et vous demande laquelle retirer. Il affiche ensuite la liste exacte de ce qui sera supprimé, puis vous demande de taper le nom de domaine pour confirmer : sans cette saisie, rien n’est touché.

Pour voir ce qui serait fait sans rien modifier : ajoutez --dry-run (voir les options plus bas).

La sauvegarde finale

Avant toute suppression, le désinstallateur propose (oui par défaut) une dernière sauvegarde dans /root/velnex-uninstall-backup-<nom>-<date>/ (lisible par root uniquement) :

Fichier	Contenu
`database.sql.gz`	la base de données complète
`files.tar.gz`	le `.env` (dont `APP_KEY`) et `storage/` (fichiers, factures PDF, extensions)
`config/`	la configuration Nginx, PHP-FPM, services et cron de l’installation

Si la sauvegarde échoue, la désinstallation s’arrête sans rien supprimer. Copiez ce dossier hors du serveur si vous comptez l’éteindre.

Ce qui est supprimé

Pour l’installation choisie, et seulement elle :

les services velnex-queue, velnex-console et velnex-update.timer (arrêtés puis retirés) et le cron /etc/cron.d/velnex ;
le pool PHP-FPM, le site Nginx et ses réglages (Nginx est testé avec nginx -t avant d’être rechargé : en cas de refus, les fichiers sont remis en place et rien d’autre n’est fait) ;
le certificat Let’s Encrypt du domaine ;
la base de données et son utilisateur MariaDB ;
le dossier d’installation (/var/www/velnex) et l’utilisateur système du site (velnex-php) ;
le journal et le fichier /root/velnex-install.txt de l’installation.

Les éléments déjà absents sont simplement ignorés : la commande peut être relancée sans risque.

Ce qui n’est pas touché

les autres sites du serveur, et les autres installations Velnex (VELNEX_INSTANCE) ;
un dossier d’addons hors de l’installation (VEXORA_ADDONS_PATH) : conservé, sauf si vous répondez oui à la question ;
SSH et le pare-feu : quand la dernière installation Velnex est retirée, le désinstallateur propose de fermer les règles HTTP/HTTPS qu’il avait ouvertes (non par défaut), jamais SSH, et UFW reste actif ;
les paquets (Nginx, PHP 8.3, MariaDB, Certbot) et le dépôt PHP ajouté sur Ubuntu 22.04 / Debian 12 : proposés à la désinstallation, un par un, seulement pour la dernière installation (non par défaut) et seulement si rien d’autre ne les utilise ;
les comptes de connexion : seul le compte système du site est supprimé, jamais un compte avec un shell ou des droits d’administration.

Les options

Option	Rôle
`--dry-run`	simulation : affiche tout ce qui serait fait, sans rien modifier
`--instance=demo`	l’installation à retirer (`velnex` pour celle par défaut, ou le nom donné à `VELNEX_INSTANCE`)
`--all`	toutes les installations Velnex du serveur
`--no-backup`	pas de sauvegarde finale (déconseillé)
`--yes`	sans questions, avec `VELNEX_CONFIRM_DOMAIN=<domaine>` obligatoire

Les options se placent après la commande :

bash <(curl -fsSL https://licenses.velnex.app/uninstall.sh) --dry-run
VELNEX_CONFIRM_DOMAIN=billing.mon-hebergeur.fr \
bash <(curl -fsSL https://licenses.velnex.app/uninstall.sh) --instance=velnex --yes

Tout est enregistré dans /var/log/velnex-uninstall.log.

Libérer la licence

La licence reste liée au domaine sur le serveur de licences. Pour l’utiliser ailleurs : espace client → votre licence → Délier le domaine (ou contactez le support). Supprimez aussi l’enregistrement DNS du domaine si vous ne l’utilisez plus.

Réinstaller plus tard

Relancez la commande d’installation, puis restaurez la sauvegarde finale comme pour un changement de serveur (voir « Changer de serveur ou de domaine ») : database.sql.gz dans la nouvelle base, files.tar.gz dans le dossier d’installation, puis le mot de passe de base de /root/velnex-install.txt dans le .env.