Comment installer Node.js sur un VPS Ubuntu ou Debian ?
Installer une version LTS récente de Node.js avec NodeSource ou nvm sur Ubuntu 24.04 et Debian 12, garder l’application en ligne avec PM2 et la relancer au
Le paquet nodejs des dépôts officiels installe Node.js 18 sur Ubuntu 24.04 comme sur Debian 12, une version qui ne reçoit plus de correctifs depuis avril 2025. Pour une application ou un bot en production, installez une version LTS : Node.js 26 est la LTS active au 17 novembre 2026, Node.js 24 reste maintenu. Les commandes de ce guide ont été testées sur Ubuntu 24.04 et Debian 12.
Procédure étape par étape
-
Choisir la méthode
NodeSource ajoute un dépôt APT : une seule version pour tout le système, mise à jour avec apt upgrade. nvm installe Node.js dans le dossier d’un utilisateur et permet d’avoir plusieurs versions côte à côte. Pour un seul service, NodeSource suffit ; pour plusieurs projets aux versions différentes, prenez nvm.
-
Installer avec NodeSource
En root, téléchargez le script setup_26.x, lisez-le si vous le souhaitez, exécutez-le avec bash puis lancez apt install -y nodejs. Le paquet contient déjà npm : n’installez pas le paquet npm de la distribution en plus.
-
Ou installer avec nvm
Connecté avec l’utilisateur qui fera tourner l’application, installez d’abord curl et libatomic1, puis lancez le script d’installation de nvm v0.41.0. Rechargez le shell avec source ~/.bashrc, puis nvm install --lts installe la dernière LTS et en fait la version par défaut.
-
Vérifier les versions
node -v doit afficher v26 suivi du numéro de correctif et npm -v une version 11. Si node -v affiche encore v18, l’ancien paquet de la distribution passe en premier : which node montre le binaire utilisé.
-
Lancer l’application avec PM2
Installez PM2 avec npm install -g pm2, placez-vous dans le dossier du projet, puis pm2 start index.js --name app. PM2 relance le processus s’il plante ; pm2 logs app affiche sa sortie et pm2 restart app le redémarre après une mise à jour du code.
-
Relancer au démarrage du VPS
pm2 startup crée un service systemd ; avec un utilisateur non root, il affiche une commande sudo env PATH= à copier telle quelle. Lancez ensuite pm2 save pour enregistrer la liste des processus que PM2 rétablira après un redémarrage.
Node.js 26 LTS avec NodeSource (root)
apt update && apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_26.x -o nodesource_setup.sh
bash nodesource_setup.sh
apt install -y nodejs
node -v
npm -v
Node.js avec nvm (utilisateur de l’application)
sudo apt install -y curl libatomic1
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm install 24
nvm alias default 26
nvm ls
PM2 : lancer, suivre et relancer au démarrage
npm install -g pm2
cd ~/app
pm2 start index.js --name app
pm2 list
pm2 logs app --lines 50
pm2 startup
pm2 save
Avant de commencer
Il vous faut un accès SSH au VPS et un utilisateur dédié à l’application plutôt que root : adduser app le crée. Si apt install nodejs a déjà été lancé, retirez cette ancienne version avec apt remove nodejs avant de passer à NodeSource ou à nvm, pour éviter que deux binaires se fassent concurrence.
- Une application Node.js simple ou un bot Discord tourne avec moins de 200 Mo de RAM ; l’installation des dépendances avec npm demande davantage pendant quelques secondes.
- Le fichier engines du package.json ou un fichier .nvmrc indique la version attendue par le projet.
Plusieurs versions avec nvm
nvm install 24 ajoute Node.js 24 à côté de la 26, nvm use 24 bascule le shell courant et nvm alias default 26 choisit la version des nouveaux shells. Dans un dossier qui contient un fichier .nvmrc avec 24, nvm use sans argument charge la bonne version. Les versions installées par nvm vivent dans ~/.nvm : elles n’existent que pour cet utilisateur, et un service systemd ou une tâche cron doit appeler le chemin complet du binaire, ou passer par PM2.
Ouvrir l’application sur Internet
Un bot Discord n’a besoin d’aucun port entrant : il se connecte lui-même à Discord. Une API ou un site, en revanche, écoute sur un port comme 3000. Le plus propre est de le laisser sur 127.0.0.1 et de placer Nginx devant, avec un certificat Let’s Encrypt ; à défaut, ouvrez le port dans UFW et dans le pare-feu du panel.
Erreurs courantes et solutions
La plupart des erreurs viennent d’une version de Node.js différente de celle attendue, ou d’un shell qui n’a pas chargé nvm.
- nvm: command not found juste après l’installation : le shell n’a pas encore lu ~/.bashrc. Lancez source ~/.bashrc ou ouvrez une nouvelle session SSH.
- node: error while loading shared libraries: libatomic.so.1 avec nvm : la bibliothèque manque sur une installation minimale. apt install libatomic1 corrige l’erreur, sans réinstaller Node.js.
- npm ERR! code EACCES sur npm install -g : le dossier global appartient à root. Avec NodeSource, installez les outils globaux en root ; avec nvm, lancez la commande sans sudo.
- SyntaxError: Unexpected token ou ERR_REQUIRE_ESM au démarrage : le projet attend une version plus récente. Comparez node -v avec le champ engines du package.json.
- L’application ne revient pas après un redémarrage du VPS : pm2 save n’a pas été lancé après le dernier pm2 start, ou la commande affichée par pm2 startup n’a pas été exécutée.
VPS ou hébergement de bots ?
Pour un seul bot Discord en Node.js, l’hébergement de bots ACLClouds évite toute cette installation : vous envoyez le code, le panel installe les dépendances, lance le bot 24h/24 et le redémarre s’il plante. L’offre gratuite (315 Mo de RAM) accepte Node.js et Python ; l’offre Starter coûte 2,99 € par mois, ou 2,39 € par mois avec un engagement d’un an (prix au 17 novembre 2026).
Le VPS se justifie pour plusieurs applications, une API avec sa base de données ou un besoin de contrôle complet. Le VPS Mini (2 vCPU, 8 Go de RAM, 40 Go de stockage) coûte 4,99 € par mois sans engagement, ou 3,99 € par mois avec un engagement d’un an, avec un réseau jusqu’à 1 Gbit/s.
Vérification rapide
- node -v affiche une version LTS (v26 ou v24).
- pm2 list montre l’application en online.
- L’application revient seule après un redémarrage du VPS.
- L’application ne tourne pas en root.
Questions fréquentes
Pourquoi ne pas installer Node.js avec apt install nodejs ?
Les dépôts d’Ubuntu 24.04 et de Debian 12 fournissent Node.js 18, dont le support a pris fin en avril 2025, et de nombreuses bibliothèques récentes, comme Vite 8 ou ESLint 10, demandent une version plus récente. NodeSource ou nvm installent une LTS maintenue.
NodeSource ou nvm : lequel choisir ?
NodeSource convient à un serveur qui fait tourner une seule application : Node.js est disponible pour tous les utilisateurs et se met à jour avec le reste du système. nvm convient quand plusieurs projets demandent des versions différentes, ou quand vous voulez tester une nouvelle version sans toucher à celle en production.
Comment mettre à jour Node.js vers une nouvelle LTS ?
Avec NodeSource, apt upgrade applique les correctifs de la même version majeure ; pour changer de majeure, relancez le script de la nouvelle version, puis apt install nodejs. Avec nvm, nvm install --lts --reinstall-packages-from=current installe la nouvelle LTS et y recopie les paquets globaux, dont PM2. Relancez ensuite l’application et vérifiez ses journaux.
PM2 ou systemd pour garder l’application en ligne ?
Les deux redémarrent le processus après un plantage et au démarrage du VPS. PM2 est plus simple pour plusieurs applications Node.js, avec pm2 list, pm2 logs et le mode cluster ; systemd n’ajoute aucun outil et convient à un service unique. Évitez de combiner les deux pour la même application.