Procedimiento para instalar y actualizar versiones de nodejs y npm usando paquetes oficiales

#1

1.Introducción

A continuación se explica cómo instalar o actualizar una máquina para que disponga de versiones más actuales de nodejs y npm.

La actualización/instalación la realizaremos utilizando los paquetes oficiales proporcionados por deb.nodesource.com.

2. Pasos

El sistema de paquetes de algunas distribuciones antiguas como Debian Buster, a día de hoy, llega únicamente a la versión 10.15.2. Si queremos instalar una versión 14/16/18, sería seguir los siguientes pasos:

>> cd /usr/src/
>> apt-get update
>> apt-get install curl

# para instalar versiones 22.0 – revisado el 04/09/2025 (recomendado)
>> curl -sL https://deb.nodesource.com/setup_22.x | bash -

# para instalar versiones 20.0 – revisado el 04/09/2025 (recomendado)
>> curl -sL https://deb.nodesource.com/setup_20.x | bash -

# para instalar versiones 18.0 – revisado el 02/09/2025 (recomendado)
>> curl -sL https://deb.nodesource.com/setup_18.x | bash -

# para instalar versiones 16.0 – revisado el 24/02/2022
>> curl -sL https://deb.nodesource.com/setup_16.x | bash -

# para instalar versiones 14.0
>> curl -sL https://deb.nodesource.com/setup_14.x | bash -

>> apt-get install nodejs

3. Borrado de paquetes antiguos en máquinas con Nodejs

Si se dispone de una instalación antigua, pedirá quitarla en este paso, borrando los siguientes paquetes. Es completamente seguro:

 Los siguientes paquetes se ELIMINARÁN:
   libnode-dev libnode64 node-gyp nodejs-doc npm
 Se actualizarán los siguientes paquetes:
   nodejs
 1 actualizados, 0 nuevos se instalarán, 5 para eliminar y 85 no actualizados.
 Se necesita descargar 29,7 MB de archivos.
 Se utilizarán 147 MB de espacio de disco adicional después de esta operación.
 ¿Desea continuar? [S/n] s

Aceptaremos el borrado y dejaremos que se instale el paquete unificado nodejs.

4. Verificar instalación tras instalación

Tras la actualización/instalación, verificar las versiones con:

>> node --version
>> npm --version
# el siguiente comando: obsoleto desde la 16.0 (28/04/2022)
>> nodejs --version

NOTA: este procedimiento ya instala npm (la versión asociada al nodejs que que hayamos elegido)

5. Instalación de versiones específicas de npm

Tras la instalación de la versión deseada de nodejs, es posible que no se instale la versión esperada de npm. Para resolverlo, puede instalar la versión específica con:

# Ejemplo para instalar npm 9.2.0
>> npm install -g npm@9.2.0

6. Revisión/histórico

  • 02/09/2025 – Procedimiento probado para instalar nodejs 18.20.8 en debian buster (10.13)

7. Resolución de errores conocidos

  1. 02/09/2025: El procedimiento descrito en este artículo es útil para reparar el siguiente error de actualización npm defectuosa:

    ERROR: npm v9.2.0 is known not to run on Node.js v10.15.2. You'll need to upgrade
to a newer Node.js version in order to use this version of npm. This version of
npm supports the following node versions: `^14.17.0 || ^16.13.0 || >=18.0.0`. You
can find the latest version at https://nodejs.org/.

ERROR:
/usr/local/lib/node_modules/npm/lib/utils/exit-handler.js:22
  const hasLoadedNpm = npm?.config.loaded
                           ^

SyntaxError: Unexpected token .
    at new Script (vm.js:79:7)
    at createScript (vm.js:251:10)
    at Object.runInThisContext (vm.js:303:10)
    at Module._compile (internal/modules/cjs/loader.js:657:28)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:700:10)
    at Module.load (internal/modules/cjs/loader.js:599:32)
    at tryModuleLoad (internal/modules/cjs/loader.js:538:12)
    at Function.Module._load (internal/modules/cjs/loader.js:530:3)
    at Module.require (internal/modules/cjs/loader.js:637:17)
    at require (internal/modules/cjs/helpers.js:22:18)