Installer Node.js sur Ubuntu : le guide pas à pas

Pourquoi installer Node.js sur Ubuntu

Depuis que je travaille comme développeur full-stack, Node.js est devenu un outil incontournable dans mon quotidien. Que ce soit pour faire tourner un serveur Express, compiler un projet Vue.js ou React, ou simplement utiliser des outils de build comme Vite ou Webpack, Node.js est le moteur qui fait fonctionner tout l’écosystème JavaScript côté serveur.

Ubuntu est la distribution Linux la plus utilisée par les développeurs web, et c’est celle que je recommande pour les environnements de développement comme de production. La combinaison Node.js et Ubuntu offre une stabilité remarquable, des performances solides et une communauté immense pour le support technique.

Le problème, c’est qu’il existe plusieurs façons d’installer Node.js sur Ubuntu, et choisir la mauvaise méthode peut générer des conflits de versions, des problèmes de permissions ou des difficultés pour mettre à jour Node.js par la suite. Dans ce guide, je vous présente les trois méthodes principales, avec mon avis sur chacune d’entre elles.

Selon la page officielle de téléchargement de Node.js, la version LTS actuelle est la branche 24.x, qui bénéficie d’un support à long terme jusqu’en 2028. C’est cette version que je vous conseille d’installer si vous débutez.

Prérequis avant l’installation

Avant de lancer la moindre commande, je vous recommande de vérifier quelques points essentiels. Ces prérequis vous éviteront des erreurs frustrantes en cours de route.

Vérifiez votre version d’Ubuntu. Les commandes présentées dans ce guide fonctionnent sur Ubuntu 20.04, 22.04, 24.04 et 26.04 LTS. Pour connaître votre version, ouvrez un terminal et tapez :

lsb_release -a

Mettez à jour vos paquets système. C’est une étape que je ne saute jamais, même sur une installation fraîche. Elle garantit que vos dépendances sont à jour et que les certificats SSL sont corrects pour télécharger les paquets :

sudo apt update && sudo apt upgrade -y

Installez les outils de base. Certaines méthodes d’installation nécessitent curl ou wget pour récupérer des scripts. Installez-les si ce n’est pas déjà fait :

sudo apt install -y curl wget gnupg2 ca-certificates

Vérifiez qu’aucune version de Node.js n’est déjà installée. Des conflits entre plusieurs installations peuvent provoquer des comportements imprévisibles. Pour vérifier :

node -v
npm -v
which node

Si une version est déjà présente et que vous souhaitez repartir de zéro, consultez la section sur la désinstallation plus bas dans cet article avant de continuer.

Méthode 1 : installer Node.js via le dépôt officiel Ubuntu

C’est la méthode la plus simple, celle que l’on trouve dans la plupart des tutoriels rapides. Elle utilise le gestionnaire de paquets apt et le dépôt officiel d’Ubuntu.

sudo apt install -y nodejs npm

En une seule commande, vous installez à la fois Node.js et npm (le gestionnaire de paquets de Node). C’est rapide, c’est propre, et ça fonctionne immédiatement.

Cependant, je dois être honnête : cette méthode présente un inconvénient majeur. Les dépôts officiels d’Ubuntu maintiennent des versions stables mais souvent anciennes de Node.js. Sur Ubuntu 22.04, par exemple, le dépôt par défaut propose Node.js 12.x, alors que la version LTS actuelle est la 24.x. Cet écart de plusieurs versions majeures signifie que vous n’aurez pas accès aux dernières fonctionnalités du langage et que certains paquets npm modernes refuseront de s’installer.

Je recommande cette méthode uniquement dans deux cas précis : si vous avez besoin de Node.js pour un outil système qui ne nécessite pas une version récente, ou si vous êtes sur un serveur de production où la stabilité prime sur la nouveauté. Pour le développement au quotidien, les deux méthodes suivantes sont largement préférables.

Après l’installation, vérifiez les versions installées :

node -v
npm -v

Méthode 2 : installer Node.js avec NVM

NVM (Node Version Manager) est ma méthode préférée et celle que je conseille à tous les développeurs. Je l’utilise au quotidien sur mes machines de développement depuis des années, et je n’ai jamais eu de problème de permissions ou de conflit de versions.

Le principe est simple : NVM s’installe dans votre répertoire utilisateur et vous permet de télécharger, installer et basculer entre différentes versions de Node.js en une seule commande. Pas besoin de sudo, pas de risque de casser votre système.

Étape 1 : installer NVM

Téléchargez et exécutez le script d’installation officiel de NVM :

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

Ce script ajoute automatiquement les lignes nécessaires à votre fichier ~/.bashrc (ou ~/.zshrc si vous utilisez Zsh). Rechargez ensuite votre terminal :

source ~/.bashrc

Vérifiez que NVM est bien installé :

nvm --version

Étape 2 : installer Node.js via NVM

Pour installer la dernière version LTS de Node.js (celle que je recommande pour la plupart des projets) :

nvm install --lts

Pour installer une version spécifique, par exemple Node.js 20 ou Node.js 24 :

nvm install 20
nvm install 24

Étape 3 : basculer entre les versions

C’est là que NVM brille vraiment. Vous pouvez lister les versions installées et passer de l’une à l’autre instantanément :

nvm ls
nvm use 20
nvm use 24

Pour définir une version par défaut qui sera utilisée à chaque ouverture de terminal :

nvm alias default 24

Cette flexibilité est précieuse quand vous travaillez sur plusieurs projets qui nécessitent des versions différentes de Node.js. Dans le cadre de missions freelance en informatique, je jongle régulièrement entre des projets legacy en Node 18 et des projets récents en Node 24, et NVM rend cette transition transparente.

Étape 4 : fichier .nvmrc pour les projets

Je vous recommande de créer un fichier .nvmrc à la racine de chaque projet pour fixer la version de Node requise :

echo "24" > .nvmrc

Ensuite, un simple nvm use dans le répertoire du projet chargera automatiquement la bonne version. C’est une pratique que j’adopte systématiquement, surtout en équipe.

Méthode 3 : installer Node.js via NodeSource

NodeSource maintient des dépôts apt optimisés qui fournissent les dernières versions de Node.js, directement compatibles avec le gestionnaire de paquets d’Ubuntu. Cette méthode est un bon compromis entre la simplicité d’apt et la fraîcheur des versions.

Pour installer Node.js 24.x via NodeSource, exécutez les commandes suivantes :

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs

Le script configure automatiquement le dépôt NodeSource dans votre système, puis l’installation se fait via apt comme d’habitude. npm est inclus dans le paquet, vous n’avez pas besoin de l’installer séparément.

Cette méthode est particulièrement adaptée aux serveurs de production et aux environnements DevOps où vous voulez une version récente de Node.js tout en conservant la gestion centralisée des paquets via apt. Elle s’intègre parfaitement dans les scripts d’automatisation et les fichiers Dockerfile.

Pour les versions antérieures, remplacez simplement le numéro dans l’URL. Par exemple, pour installer Node.js 20 :

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

Un point important : contrairement à NVM, cette méthode installe Node.js au niveau du système, ce qui signifie que tous les utilisateurs de la machine partageront la même version. Si vous avez besoin de versions multiples, NVM reste la meilleure option.

Comparatif des méthodes d’installation

Pour vous aider à choisir la méthode la plus adaptée à votre situation, voici un tableau comparatif que j’ai préparé en fonction de mon expérience avec chacune d’entre elles.

Mon verdict est clair : pour le développement, NVM est la solution idéale. Pour un serveur de production, NodeSource offre le meilleur équilibre entre fraîcheur et stabilité. Le dépôt apt par défaut ne devrait être utilisé que si vous n’avez pas le choix.

Vérifier et configurer Node.js après l’installation

Quelle que soit la méthode choisie, je vous recommande de toujours valider votre installation avant de commencer à travailler. Voici les vérifications essentielles.

Vérifier les versions installées

node -v
npm -v

Ces deux commandes doivent retourner des numéros de version sans erreur. Si vous obtenez un message “command not found”, c’est que l’installation n’a pas abouti ou que le chemin (PATH) n’est pas correctement configuré.

Mettre à jour npm

La version de npm livrée avec Node.js n’est pas toujours la dernière. Pour la mettre à jour :

npm install -g npm@latest

Si vous utilisez l’installation système (apt ou NodeSource), vous aurez besoin de sudo devant cette commande. Avec NVM, ce n’est pas nécessaire, ce qui est un avantage supplémentaire.

Tester avec un script simple

Créez un fichier test.js pour vérifier que tout fonctionne correctement :

echo 'console.log("Node.js fonctionne sur Ubuntu !");' > test.js
node test.js

Vous devriez voir le message s’afficher dans votre terminal. Si c’est le cas, félicitations : votre installation est opérationnelle.

Configurer le registre npm

Par défaut, npm utilise le registre officiel registry.npmjs.org. Si vous travaillez dans une entreprise qui utilise un registre privé (comme Verdaccio ou GitHub Packages), configurez-le ainsi :

npm config set registry https://votre-registre-prive.com/

Pour vérifier votre configuration actuelle :

npm config list

Cette étape de vérification est d’autant plus importante si vous travaillez sur des projets impliquant du TypeScript ou des frameworks front-end modernes qui dépendent de nombreux paquets npm.

Désinstaller Node.js proprement sur Ubuntu

La désinstallation propre est tout aussi importante que l’installation. Des résidus de paquets peuvent provoquer des conflits difficiles à diagnostiquer lors d’une réinstallation. Voici comment procéder selon la méthode utilisée.

Désinstaller Node.js installé via apt

sudo apt remove -y nodejs npm
sudo apt purge -y nodejs npm
sudo apt autoremove -y

La commande purge supprime également les fichiers de configuration, ce qui garantit une désinstallation complète. La commande autoremove nettoie les dépendances orphelines.

Désinstaller Node.js installé via NVM

nvm deactivate
nvm uninstall 24

Pour supprimer NVM lui-même, retirez le répertoire ~/.nvm et les lignes correspondantes dans votre fichier ~/.bashrc :

rm -rf ~/.nvm

Puis éditez votre fichier ~/.bashrc pour supprimer les trois lignes ajoutées par NVM (celles qui commencent par export NVM_DIR).

Désinstaller Node.js installé via NodeSource

sudo apt remove -y nodejs
sudo rm /etc/apt/sources.list.d/nodesource.list
sudo apt update

La suppression du fichier de configuration du dépôt est essentielle pour éviter des erreurs lors des futures mises à jour système. Je rencontre régulièrement ce problème chez des clients qui ont oublié cette étape et se retrouvent avec des avertissements apt incompréhensibles.

Comme le précise la documentation Ubuntu francophone sur Node.js, il est important de nettoyer les fichiers de configuration des dépôts tiers après une désinstallation pour maintenir un système sain.

Erreurs fréquentes et solutions

Au fil des années, j’ai rencontré (et résolu) des dizaines de problèmes liés à l’installation de Node.js sur Ubuntu. Voici les plus courants et leurs solutions.

Erreur EACCES : permission refusée

C’est l’erreur la plus fréquente. Elle survient quand vous essayez d’installer un paquet npm global sans les droits suffisants :

npm ERR! Error: EACCES: permission denied

Solution : si vous utilisez l’installation système, vous pouvez modifier le répertoire global de npm :

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

Ajoutez la ligne export PATH dans votre fichier ~/.bashrc pour la rendre permanente. La meilleure solution reste cependant de passer à NVM, qui élimine ce problème à la source.

Conflit entre plusieurs installations

Si vous avez installé Node.js via plusieurs méthodes, le système peut utiliser une version inattendue. Pour identifier d’où vient le binaire utilisé :

which node
which npm

Si le chemin pointe vers /usr/bin/node alors que vous attendez la version NVM (qui se trouve dans ~/.nvm/), c’est qu’il y a un conflit. Désinstallez la version système avec apt, puis rechargez votre terminal.

Le paquet “node” au lieu de “nodejs”

Sur certaines anciennes versions d’Ubuntu, le paquet node ne correspond pas à Node.js mais à un outil radio amateur. Si la commande node ne fonctionne pas après l’installation, installez le paquet nodejs-legacy ou utilisez un lien symbolique :

sudo ln -s /usr/bin/nodejs /usr/bin/node

Ce problème est de moins en moins fréquent sur les versions récentes d’Ubuntu, mais il peut encore se produire sur Ubuntu 18.04 ou antérieur.

Problèmes de compilation de modules natifs

Certains paquets npm nécessitent des outils de compilation C++ pour fonctionner. Si vous obtenez des erreurs lors de l’installation de paquets comme bcrypt, sharp ou node-gyp, installez les outils de build :

sudo apt install -y build-essential python3

Ces outils sont indispensables dans les environnements de développement. Si vous travaillez sur la création d’une application mobile avec React Native, vous en aurez aussi besoin pour compiler certaines dépendances natives.

Dans un environnement DevOps, ces dépendances de build doivent être intégrées dans vos images Docker ou vos scripts de provisioning pour garantir la reproductibilité des déploiements. La documentation officielle de npm détaille les solutions pour les erreurs de permissions les plus courantes.