Cómo desplegar una app Node.js en cPanel paso a paso
Node.js es un entorno de ejecución de JavaScript de código abierto que permite construir aplicaciones de servidor. Con Node.js puedes escribir y ejecutar JavaScript en el servidor, no solo en el navegador, lo que lo hace ideal para APIs, aplicaciones en tiempo real, bots y herramientas de automatización.
Node.js es especialmente eficiente para manejar múltiples solicitudes simultáneas gracias a su arquitectura basada en eventos y sin bloqueo de I/O. Es uno de los entornos más populares entre desarrolladores por su ecosistema de paquetes npm y su capacidad de integrarse fácilmente con otras tecnologías.
ℹ️ Node.js está disponible en todos los planes de hosting compartido de Nicalia. No necesitas un VPS ni servidor dedicado para desplegar aplicaciones Node.js.
Cómo desplegar una App Node.js en cPanel: guía paso a paso
Paso 1 — Acceder a Setup Node.js App
Inicia sesión en tu cuenta cPanel y busca «Setup Node.js App» en la sección Software.
Paso 2 — Crear una nueva aplicación
Haz clic en «Create Application» para iniciar el asistente de configuración.
Paso 3 — Seleccionar la versión de Node.js
En el campo «Node.js version», selecciona la versión que necesita tu aplicación. Elige siempre la versión LTS (Long Term Support) más reciente salvo que tu aplicación requiera una versión específica por compatibilidad con sus dependencias.
Paso 4 — Indicar la ruta de la aplicación (Application root)
En el campo «Application root», introduce la ruta del directorio donde tienes los archivos de tu aplicación Node.js. Esta ruta es relativa al directorio home de tu cuenta — por ejemplo, si tus archivos están en /home/usuario/miapp/, introduce simplemente miapp.
Si todavía no has subido los archivos, crea primero el directorio y sube el código de la aplicación por FTP o desde el Administrador de Archivos de cPanel.
Paso 5 — Especificar la URL de la aplicación
En el campo «Application URL», especifica la URL desde la que se accederá a tu aplicación. Puedes elegir:
- El dominio raíz:
tudominio.com - Un subdominio:
app.tudominio.com - Una ruta del dominio:
tudominio.com/miapp
Paso 6 — Indicar el archivo de inicio (Application Startup File)
En el campo «Application Startup File», introduce el nombre del archivo JavaScript principal de tu aplicación — el punto de entrada que Node.js ejecutará al arrancar. Debe tener extensión .js. Los nombres más habituales son app.js, server.js o index.js.
Paso 7 — Crear la aplicación
Una vez rellenados todos los campos, haz clic en «Create» para crear la aplicación. cPanel configurará el entorno Node.js y desplegará tu aplicación.
Para verificar que todo funciona correctamente, abre el navegador y accede a la URL que configuraste. Si la aplicación está activa, verás un mensaje indicando la versión de Node.js que estás usando:
Pasos siguientes tras desplegar la aplicación
- Instalar dependencias npm: si tu aplicación usa paquetes de npm, necesitas instalarlos. Desde la pantalla de gestión de la aplicación en cPanel, haz clic en «Run NPM Install» para instalar las dependencias definidas en tu
package.json. - Configurar variables de entorno: puedes añadir variables de entorno desde la misma pantalla de gestión, en la sección «Environment Variables». Útil para credenciales, claves de API o configuraciones que no deben estar en el código.
- Reiniciar la aplicación: tras hacer cambios en el código, usa el botón «Restart» desde la pantalla de gestión para aplicar los cambios sin necesidad de recrear la aplicación.
- Verificar los logs: si la aplicación falla, revisa los logs de error desde cPanel o accede al archivo de log que cPanel genera automáticamente para cada aplicación Node.js.
Errores frecuentes al desplegar apps Node.js en cPanel
La URL de la aplicación devuelve error 503 o «Application Not Started»
La aplicación no se ha iniciado correctamente. Ve a la pantalla de gestión en Setup Node.js App y verifica que el estado es «Running». Si no lo está, haz clic en «Start App». También puede ocurrir que el archivo Startup File no existe en la ruta indicada — verifica que el archivo app.js (o el que hayas configurado) está en el directorio de Application root.
Error al ejecutar npm install — módulos no encontrados
El archivo package.json no está en el directorio raíz de la aplicación, o hay un error en sus dependencias. Verifica que package.json existe en el Application root y que los nombres de los paquetes son correctos. Si el error persiste, revisa el log de npm que cPanel muestra tras la instalación.
La aplicación funciona en local pero no en cPanel
Las causas más frecuentes son: (1) la versión de Node.js seleccionada en cPanel no coincide con la que usaste en local — usa node --version en local y selecciona la misma en cPanel; (2) algún módulo nativo (que requiere compilación) no es compatible con el entorno de cPanel; (3) la aplicación intenta escuchar en un puerto fijo — en cPanel, el puerto lo asigna el sistema automáticamente a través del socket de la aplicación.
Los cambios en el código no se reflejan en la aplicación
Node.js no recarga automáticamente el código al modificar archivos. Tras cada cambio debes reiniciar la aplicación desde el botón «Restart» en la pantalla de gestión de Setup Node.js App.
Preguntas frecuentes sobre Node.js en cPanel
¿Puedo usar Node.js en mi hosting compartido de Nicalia?
Sí. Node.js está disponible en todos los planes de hosting compartido de Nicalia sin necesidad de un VPS o servidor dedicado. Puedes desplegar aplicaciones Node.js directamente desde la sección Software → Setup Node.js App de cPanel.
¿Qué versiones de Node.js están disponibles en cPanel?
Las versiones disponibles dependen de las instaladas en el servidor en ese momento. Puedes ver las versiones disponibles en el selector del Paso 3 de la guía. Para conocer las versiones actuales del servidor de Nicalia, contacta con el soporte o consúltalo directamente en el selector al crear la aplicación.
¿Puedo tener varias aplicaciones Node.js en el mismo hosting?
Sí. Puedes crear múltiples aplicaciones Node.js en el mismo hosting, cada una en su propio directorio y con su propia URL (dominio, subdominio o ruta). Cada aplicación funciona de forma independiente con su propia versión de Node.js y sus propias dependencias.
¿Cómo actualizo mi aplicación Node.js después de desplegarla?
Sube los archivos actualizados al directorio de la aplicación por FTP o desde el Administrador de Archivos de cPanel. Si has añadido o modificado dependencias npm, ejecuta «Run NPM Install» desde la pantalla de gestión. Luego haz clic en «Restart» para aplicar los cambios.
¿Puedo usar Express, Fastify u otros frameworks con Node.js en cPanel?
Sí. Puedes usar cualquier framework Node.js que sea compatible con tu versión: Express, Fastify, Koa, Hapi, etc. Solo necesitas incluirlos como dependencias en tu package.json y ejecutar npm install desde la pantalla de gestión de la aplicación en cPanel.
