Node.js : installation sur Ubuntu

Node.js est un environnement d’exécution JavaScript côté serveur et en ligne de commande. Ce guide l’installe sur Ubuntu 24.04 et 26.04. Les exemples utilisent des noms génériques.

Choisir la version

Version	Statut	Usage
Node.js 24 (« Krypton »)	LTS	Choix par défaut pour un serveur
Node.js 22 (« Jod »)	LTS, maintenance	Pour rester compatible avec une application existante
Node.js 26	Current, devient LTS le 28 octobre 2026 (date annoncée par le projet)	Nouveautés, ou à adopter une fois passée en LTS
Node.js 18, 20 et versions impaires (23, 25)	Fin de vie	À éviter

Pour une application en production, utiliser une version LTS (« Long Term Support »). Les dates exactes de fin de support sont sur nodejs.org/en/about/previous-releases.

Quelle méthode d’installation ?

Méthode	Avantages	Inconvénients	Pour qui
NodeSource (dépôt apt)	Version choisie, mises à jour avec le système	Dépôt tiers	Serveur de production
Paquet Ubuntu (apt install nodejs)	Aucun dépôt à ajouter	Version imposée par la distribution, souvent ancienne	Essais rapides
snap	Canal de version, mises à jour automatiques	Confinement classic, démarrage plus lent	Poste de travail, serveur simple
nvm	Plusieurs versions côte à côte, par utilisateur	Installé dans le dossier personnel, pas adapté à un service système	Développement (voir Gérer plusieurs versions)

Méthode 1 : dépôt NodeSource (recommandé pour un serveur)

Télécharger le script d’installation du dépôt, le lire, puis l’exécuter. Remplacer 24 par la version majeure voulue (22, 26…) :

curl -fsSL https://deb.nodesource.com/setup_24.x -o nodesource_setup.sh
less nodesource_setup.sh          # lecture avant exécution (q pour quitter)
sudo bash nodesource_setup.sh
sudo apt install -y nodejs

Le paquet nodejs de NodeSource contient déjà npm : ne pas installer le paquet npm d’Ubuntu en plus.

Attention

Les commandes de type curl … | sudo bash exécutent du code téléchargé sans relecture. Télécharger d’abord le script, comme ci-dessus, permet de l’inspecter.

Méthode 2 : paquet Ubuntu

sudo apt update
sudo apt install nodejs npm

Ubuntu	Version de nodejs fournie
24.04	18 (fin de vie)
26.04	22 (LTS)

Attention

Sur Ubuntu 24.04, le paquet nodejs fourni par Ubuntu est en version 18, qui ne reçoit plus de correctifs de sécurité : utiliser NodeSource ou nvm pour une version supportée.

Méthode 3 : snap

sudo snap install node --classic --channel=24      # canal de la version majeure voulue
snap list node
sudo snap refresh node --channel=26                # changer de version majeure

Méthode 4 : nvm

Voir Gérer plusieurs versions (nvm).

Vérifier l’installation

node --version          # par exemple v24.x.x
npm --version
command -v node         # emplacement de l'exécutable
node -e "console.log('Node.js fonctionne :', process.version)"

Outils de compilation (modules natifs)

Certains paquets npm compilent du code C/C++ à l’installation (via node-gyp). Installer les outils nécessaires :

sudo apt install build-essential python3

Installer des paquets globaux sans sudo

Avec Node installé par le système, npm install -g écrit dans un dossier protégé (erreur EACCES). Configurer un dossier personnel :

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
npm install -g typescript       # fonctionne sans sudo

Attention

N’utilisez pas sudo npm install -g : cela donne les droits d’administration aux scripts d’installation des paquets. Préférer le dossier personnel ci-dessus.

Mise à jour

Méthode	Mise à jour dans la même version majeure	Changement de version majeure
NodeSource	sudo apt update && sudo apt upgrade	Relancer le script setup_NN.x avec la nouvelle version, puis sudo apt install nodejs
Paquet Ubuntu	sudo apt update && sudo apt upgrade	Attendre la version d’Ubuntu suivante, ou passer à NodeSource
snap	Automatique (sudo snap refresh node)	sudo snap refresh node --channel=NN
nvm	nvm install --lts	idem

Avant un changement de version majeure, lancer les tests de l’application et lire les notes de version sur nodejs.org.

Désinstallation

# NodeSource ou paquet Ubuntu
sudo apt purge nodejs npm
sudo apt autoremove
sudo rm -f /etc/apt/sources.list.d/nodesource.list /etc/apt/sources.list.d/nodesource.sources
# snap
sudo snap remove node

Dépannage

Symptôme	Cause probable et solution
node: command not found	Installation incomplète ou PATH : command -v node, rouvrir le terminal
Mauvaise version affichée	Un autre Node est prioritaire dans le PATH : which -a node (nvm, snap et apt coexistent)
EACCES: permission denied avec npm install -g	Dossier global protégé : voir la section sans sudo ci-dessus
Erreur de compilation node-gyp	Installer build-essential et python3
npm: command not found après apt install nodejs	Le paquet Ubuntu ne contient pas npm : sudo apt install npm

Ubuntu 24.04 et 26.04 : différences à connaître

Changement cassant — Ubuntu 26.04 : sudo remplacé par sudo-rs

La commande sudo est désormais fournie par sudo-rs (l’ancienne version devient sudo.ws). Les commandes de ce guide fonctionnent à l’identique. Des scripts qui analysent la sortie de sudo, ou une configuration sudoers avancée, sont à revérifier.

Changement cassant — mise à niveau d’Ubuntu 24.04 vers 26.04 : version de Node fournie par apt

Le paquet nodejs d’Ubuntu passe de la version 18 (24.04) à la version 22 (26.04). Une application installée avec le paquet d’Ubuntu changera donc de version majeure lors de la mise à niveau : lancer les tests avant, ou fixer la version avec NodeSource ou nvm.

Changement cassant — Node.js 25 et suivants : Corepack n’est plus fourni

À partir de Node.js 25 (donc avec Node.js 26), Corepack n’est plus livré avec Node.js. Il reste inclus dans Node.js 22 et 24. Voir Gestionnaires de paquets.

Ubuntu 26.04 : disponibilité

Les dépôts NodeSource et le snap node proposent leurs versions pour Ubuntu 24.04 et 26.04. En cas d’erreur sur 26.04, consulter la page du projet.

Pour aller plus loin

• Site officiel : nodejs.org
• Installation par paquet : nodejs.org/en/download/package-manager

Dans la même rubrique

• Installation
• Gérer plusieurs versions (nvm)
• Premiers pas
• npm : commandes essentielles
• Gestionnaires de paquets : pnpm et Yarn
• Mise en production avec systemd