Aller au contenu
Runbook

Installer Node.js sur Ubuntu / Debian

Runtime JavaScript côté serveur, fondé sur le moteur V8, livré avec le gestionnaire de paquets npm.

Runtimejavascriptruntimebackendv8npm

Installation

Dépôt NodeSource (LTS) · apt
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

Le paquet "nodejs" du dépôt par défaut d'Ubuntu/Debian est souvent ancien ; NodeSource fournit la LTS à jour avec npm.

Vérifier l'installation

Vérifier
node --version

Fichiers importants

TypeCheminDescription
config~/.npmrcConfiguration utilisateur de npm (registre, proxy, jetons d'authentification).
binaire/usr/bin/nodeExécutable du runtime installé par le paquet NodeSource.

Outils en ligne de commande

  • nodeLe runtime JavaScript.
  • npmGestionnaire de paquets Node.js.
  • npxExécute un binaire d'un paquet sans l'installer globalement.
  • corepackActive et gère pnpm et yarn. Encore présent avec Node 24 (LTS), mais retiré du paquet à partir de Node 25.

Désinstaller

Désinstaller
sudo apt-get purge -y nodejs
sudo rm -f /etc/apt/sources.list.d/nodesource.sources /usr/share/keyrings/nodesource.gpg /etc/apt/preferences.d/nodejs /etc/apt/preferences.d/nsolid
sudo apt-get update

À savoir

  • Le dépôt APT par défaut fournit une version de Node.js souvent en retard de plusieurs cycles ; préférez NodeSource ou un gestionnaire de versions (nvm/fnm).
  • Activez pnpm et yarn via Corepack avec "corepack enable" ; Corepack est encore fourni avec Node 24, mais il est retiré à partir de Node 25 et doit alors être installé séparément.
  • Le script setup_lts.x configure le dépôt APT NodeSource et sa clé GPG.

Installation sur Ubuntu / Debian

Le paquet nodejs présent dans les dépôts par défaut d'Ubuntu et de Debian est généralement très ancien et inadapté à un usage moderne. La méthode recommandée est le dépôt officiel NodeSource : le script setup_lts.x ajoute le dépôt APT et sa clé, puis apt-get install -y nodejs installe la dernière LTS, npm inclus. Pour épingler une version majeure précise, remplacez setup_lts.x par, par exemple, setup_22.x.

Alternative : gestionnaire de versions

Pour des environnements de développement où plusieurs versions cohabitent, nvm ou fnm sont préférables à une installation système. Ils installent Node.js dans votre répertoire utilisateur, évitant sudo pour les paquets globaux et facilitant le passage d'une version à l'autre par projet via un fichier .nvmrc.

Emplacements et configuration

Avec NodeSource, l'exécutable se trouve dans /usr/bin/node. La configuration utilisateur de npm est dans ~/.npmrc. Activez pnpm et yarn sans installation supplémentaire grâce à corepack enable.