Instalar Node.js y npm en Debian

Node.js es el entorno de ejecución que está detrás de incontables aplicaciones web, APIs y bots de Discord. En un servidor propio lo instalas en pocos minutos. En esta guía configuras Node.js junto con npm en Debian 13, Debian 12 y Debian 11. En Ubuntu funcionan exactamente los mismos comandos.

Lo decisivo es elegir la versión correcta. Las guías que antes circulaban para Node.js 10 y Node.js 12 están obsoletas: ambas versiones llevan años sin recibir actualizaciones de seguridad y no deberían seguir ejecutándose en ningún servidor.

¿Qué versión de Node.js deberías instalar?

Node.js publica una nueva versión principal dos veces al año. Solo los números de versión pares pasan a ser una línea LTS (Long Term Support) y reciben mantenimiento durante unos tres años. Las versiones impares son líneas de desarrollo de vida corta y no están pensadas para sistemas en producción.

• Node.js 24 LTS ("Krypton"): la recomendación actual para proyectos nuevos y servidores en producción.
• Node.js 22 LTS: sigue estando muy extendida y tiene sentido cuando una aplicación exige expresamente esta versión.
• Node.js 10 y 12: sin soporte desde 2021 y 2022 respectivamente. No los uses.

En caso de duda, revisa lo que indica tu aplicación. Muchos proyectos declaran la versión que necesitan en el campo "engines" de su archivo package.json.

Requisitos

• Acceso root a tu VPS o servidor root a través de SSH.
• Un Debian actualizado. Pon primero el sistema al día:

apt update && apt upgrade -y

Para poder usar el repositorio necesitas además algunas herramientas estándar:

apt install -y ca-certificates curl gnupg

Variante 1: Node.js desde los repositorios de Debian

El camino más sencillo pasa por los repositorios que ya vienen incluidos:

apt install nodejs npm -y

La ventaja: las actualizaciones llegan automáticamente junto con el resto de actualizaciones del sistema. La desventaja: los paquetes de Debian suelen ir una o dos versiones principales por detrás de la línea LTS actual. Qué versión tienes disponible lo compruebas antes de instalar con:

apt-cache policy nodejs

A fecha de julio de 2026, los repositorios entregan: Debian 13 "Trixie" Node.js 20.19, Debian 12 "Bookworm" Node.js 18.20, Ubuntu 24.04 Node.js 18.19, Ubuntu 22.04 Node.js 12.22. Si con eso te basta, ya has terminado. Si necesitas una línea LTS actual, usa la variante 2.

Variante 2: instalar Node.js 24 LTS mediante NodeSource

NodeSource ofrece repositorios oficiales para Debian y Ubuntu. Así obtienes exactamente la versión principal que quieres y sigues recibiendo actualizaciones a través de apt.

Registrar la clave de firma

El antiguo camino a través de apt-key ha desaparecido. Desde Debian 11, las claves de firma van en un directorio propio bajo /etc/apt/keyrings/:

mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg

Añadir el repositorio e instalar

A continuación, añade el repositorio. Con la variable defines la versión principal que quieres, aquí la 24:

NODE_MAJOR=24
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main" | tee /etc/apt/sources.list.d/nodesource.list

Para Node.js 22 pon en su lugar NODE_MAJOR=22. Después viene la instalación propiamente dicha:

apt update
apt install nodejs -y

npm ya viene incluido en el paquete de NodeSource. No instales aquí además el paquete "npm" de Debian, porque se produce un conflicto de paquetes.

El atajo con el script de instalación

NodeSource ofrece además un script que resume en uno los dos pasos anteriores:

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

Es cómodo, pero estás ejecutando con permisos de root un script descargado de internet. En servidores en producción, la vía de la clave y el repositorio es la opción más limpia.

Comprobar la instalación

Para terminar, consulta las dos versiones:

node --version
npm --version

Si en node aparece una salida que empieza por v22. y en npm un número de versión, la instalación ha funcionado.

Si quieres usar yarn o pnpm: ambos se activan mediante Corepack, que ya viene incluido en Node.js, así que no hace falta ninguna instalación aparte:

corepack enable

Ejecutar varias versiones de Node.js en paralelo

Si en un mismo servidor tienes varias aplicaciones con requisitos distintos, te ayuda el Node Version Manager (nvm). Instala Node.js dentro del directorio del usuario, de modo que puedes mantener varias versiones una junto a otra y cambiar entre ellas según el proyecto.

Una vez instalado nvm (para ello sigue las indicaciones del proyecto oficial), bastan estos comandos:

nvm install 24
nvm use 24
nvm alias default 24

Importante: nvm pertenece siempre a un único usuario. Los servicios del sistema que se ejecutan con otro usuario no encuentran esa instalación de Node.js. Para servicios, la instalación por paquete es la vía más fiable.

Cambiar a una versión más reciente

Si más adelante toca pasar a una nueva línea LTS, basta con que cambies el número de versión en el repositorio y actualices:

NODE_MAJOR=24
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main" | tee /etc/apt/sources.list.d/nodesource.list
apt update && apt install nodejs -y

Prueba tu aplicación después de un salto de versión. Entre dos versiones principales pueden cambiar las interfaces, y es posible que los módulos nativos antiguos haya que recompilarlos.

Errores frecuentes

• "E: Unable to locate package nodejs": Después de añadir el repositorio se olvidó ejecutar apt update.
• Conflicto de paquetes entre nodejs y npm: Has instalado el paquete "npm" de Debian junto al paquete de NodeSource. Elimina npm con apt remove npm, la versión adecuada la trae el propio Node.js.
• "NO_PUBKEY" o "signatures couldn't be verified": La clave de firma no está en /etc/apt/keyrings/, o la línea del repositorio no contiene la referencia signed-by correspondiente.
• Se sigue mostrando una versión antigua: En el sistema quedan restos de una instalación anterior. Borra bajo /etc/apt/sources.list.d/ los archivos antiguos que apunten a nodesource y vuelve a instalar después.
• Un paquete de npm falla al compilar: Faltan las herramientas de compilación para los módulos nativos. Instálalas con apt install -y build-essential python3.