/
mc-node.net →
VPS

Comment installer Node.js sur mon VPS ?

Mis à jour le 07/11/20264 min de lecture
Dans cet article
  1. Quelle version choisir ?
  2. Préparation : supprimer une ancienne version
  3. Méthode 1 : NodeSource (recommandée)
  4. Méthode 2 : nvm (par utilisateur)
  5. Vérifier la version
  6. Mettre à jour
  7. Problèmes fréquents
  8. Besoin d'aide ?

Node.js est nécessaire pour les bots Discord, les applications web et les outils modernes comme les agents IA. Le réflexe apt install nodejs n'est pas une bonne idée : Ubuntu et Debian installent ainsi une ancienne version. Sous Ubuntu 24.04, vous obtenez Node.js 18, et sous Ubuntu 22.04 même Node.js 12 ; aucune des deux n'est encore maintenue par le projet Node.js. Beaucoup de programmes actuels refusent de démarrer avec ; OpenClaw exige par exemple au moins Node.js 24.16. Dans ce guide, vous installez la version LTS actuelle de façon officielle, puis vous vérifiez la version. Les étapes concernent un VPS Linux sous Ubuntu ou Debian ; sur un VPS Windows, utilisez l'installateur de nodejs.org.

Quelle version choisir ?

Choisissez une version LTS (Long Term Support) : elle reçoit des mises à jour de sécurité pendant des années. Depuis le 28 octobre 2026, il s'agit de Node.js 26, la version utilisée dans les commandes ci-dessous. Node.js 24 reste maintenu jusqu'au 30 avril 2028 ; si un programme demande explicitement la version 24, remplacez 26 par 24. Les versions LTS du moment sont indiquées sur nodejs.org.

Il existe deux méthodes officielles. Choisissez-en une seule : les mélanger crée la confusion sur le node réellement utilisé.

  • NodeSource (recommandé pour un serveur) : Node.js s'installe comme un paquet classique dans /usr/bin/node, pour tous les utilisateurs et services, et les mises à jour arrivent avec apt upgrade.
  • nvm (Node Version Manager) : installe Node.js par utilisateur, dans son répertoire personnel. Pratique si vous voulez plusieurs versions côte à côte. Cette méthode figure aussi sur la page de téléchargement de nodejs.org.

Préparation : supprimer une ancienne version

Connectez-vous à votre VPS en SSH (voir se connecter au VPS en SSH). Si vous êtes connecté en root, vous pouvez laisser le sudo devant les commandes. Vérifiez d'abord si Node.js est déjà installé :

node -v

Si vous obtenez command not found, passez directement à l'une des méthodes. Si vous voyez une ancienne version, comme v18.19.1 ou v12.22.9, supprimez-la d'abord. Sinon, l'installation s'arrête sur un conflit avec le paquet libnode-dev :

sudo apt remove -y nodejs npm libnode-dev
sudo apt autoremove -y

Méthode 1 : NodeSource (recommandée)

Exécutez ces commandes l'une après l'autre :

sudo apt update
sudo apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_26.x -o nodesource_setup.sh
sudo -E bash nodesource_setup.sh
sudo apt install -y nodejs

Le script de NodeSource ajoute leur dépôt de paquets et leur clé de signature à apt ; la dernière ligne installe Node.js. npm est inclus, ne l'installez pas séparément. Pour voir d'abord ce que fait le script, consultez-le avant la quatrième ligne avec less nodesource_setup.sh.

Méthode 2 : nvm (par utilisateur)

Connectez-vous avec l'utilisateur qui utilisera Node.js, car nvm place tout dans son répertoire personnel. Sur une installation minimale, curl et libatomic1 manquent parfois (sans cette dernière, Node.js ne démarre pas) ; la première ligne les installe donc :

sudo apt install -y curl libatomic1
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh | bash
\. "$HOME/.nvm/nvm.sh"
nvm install 26

La troisième ligne charge nvm immédiatement dans votre session ; aux connexions suivantes, cela se fait automatiquement. Le numéro de la dernière version de nvm (ici v0.41.0) se trouve sur GitHub.

Attention : un Node.js installé avec nvm se trouve uniquement dans votre répertoire personnel. Un service systemd ou un autre utilisateur ne le trouvera pas automatiquement. Si votre bot ou votre application doit tourner comme service, NodeSource est plus pratique.

Vérifier la version

node -v
npm -v

Vous voyez maintenant par exemple v26.13.0 et 11.20.0. Si la version de Node commence par v26 (ou v24 si vous avez choisi celle-ci), c'est terminé.

Mettre à jour

Avec NodeSource, les nouvelles versions de la même branche (par exemple de 26.13 à 26.14) arrivent avec sudo apt update && sudo apt upgrade. Pour passer à une nouvelle version majeure, exécutez le script d'installation de cette version, puis relancez sudo apt install -y nodejs. Avec nvm, nvm install 26 récupère la dernière 26.x.

Problèmes fréquents

  • trying to overwrite '/usr/include/node/common.gypi' : l'ancien Node.js d'Ubuntu est encore installé, avec libnode-dev. Supprimez-le avec les commandes de la section Préparation, puis relancez sudo apt install -y nodejs.
  • node -v affiche encore l'ancienne version : votre shell garde l'ancien chemin en mémoire. Tapez hash -r ou reconnectez-vous. which -a node affiche les installations de Node.js présentes ; celle de ~/.nvm passe avant celle de NodeSource.
  • nvm: command not found : votre session actuelle ne connaît pas encore nvm. Reconnectez-vous ou exécutez \. "$HOME/.nvm/nvm.sh".
  • error while loading shared libraries: libatomic.so.1 : installez la bibliothèque manquante avec sudo apt install -y libatomic1.
  • VPS économique (OpenVZ) : les builds officiels de Node.js visent le noyau Linux 4.18 ou plus récent. Sous OpenVZ, vous partagez le noyau avec l'hôte ; vérifiez-le avec uname -r. S'il est plus ancien, Node.js peut fonctionner, mais ce n'est pas officiellement pris en charge. Pour des applications Node exigeantes, un VPS KVM est le choix le plus sûr.

Besoin d'aide ?

Vous êtes bloqué ? Ouvrez un ticket via notre page support en joignant la sortie de node -v et le message d'erreur complet.