Ir al contenido

Tu servidor Node.js

Cambiar la versión de Node.js

Elige la versión de Node.js de tu servidor desde la pestaña Arranque y qué pasa con tus dependencias al cambiarla.

2 min de lectura

Cada servidor puede usar cualquier versión de Node.js de la 16 a la 26. Se cambia en un momento y no hace falta reinstalar.

  1. En el panel de control, abre tu servidor y ve a la pestaña Arranque.

  2. En Imagen de Docker, elige la versión. Por ejemplo, Node.js v24.x LTS mantenimiento.

  3. Reinicia el servidor. En el siguiente inicio ya corre con la versión nueva.

Menú Imagen de Docker en la pestaña Arranque, con la versión Node.js v24.x LTS mantenimiento elegida

Al detectar el cambio de versión, el servidor vuelve a instalar tus dependencias automáticamente (si tienes activada Instalar dependencias al iniciar, que viene activada). Así los módulos nativos, como bcrypt o sharp, se compilan para la versión nueva. Ese primer inicio tarda un poco más.

Lo que dicen los nombres de la lista:

  • LTS activo: la versión estable más reciente, con soporte completo. Es la mejor opción para proyectos nuevos.
  • LTS mantenimiento: estable y todavía con parches de seguridad. Buena opción si una librería tuya aún no funciona con la más reciente.
  • EOL (end of life): ya no recibe parches de seguridad. Úsala solo si tu proyecto no funciona en ninguna versión más nueva, y planea actualizarlo.

Si tu package.json tiene un campo engines, elige una versión que lo cumpla:

"engines": { "node": ">=22" }

Si en lugar de la lista ves el mensaje «La imagen de Docker de este servidor fue establecida manualmente por un administrador», tu servidor tiene una configuración especial. Escríbenos por el chat y la cambiamos por ti.

  • SyntaxError o funciones que «no existen». Tu código o alguna librería usa algo que esa versión no tiene. Sube a una versión más nueva o actualiza la librería.
  • Errores con módulos nativos. Borra la carpeta node_modules desde Archivos y reinicia para que se instalen desde cero.
  • Puedes volver a la versión anterior en cualquier momento desde el mismo menú.