Comment installer Node.js sur mon VPS ?
Dans cet article
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 avecapt 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é, aveclibnode-dev. Supprimez-le avec les commandes de la section Préparation, puis relancezsudo apt install -y nodejs.node -vaffiche encore l'ancienne version : votre shell garde l'ancien chemin en mémoire. Tapezhash -rou reconnectez-vous.which -a nodeaffiche les installations de Node.js présentes ; celle de~/.nvmpasse 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 avecsudo 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.
Lancez votre serveur en 60 secondes sur notre propre matériel.