Cómo subir tu proyecto Node.js a cPanel

Escrito por Enrique Mosquera Rojas
Última actualización lunes, ago 04, 2025

1. Comprime tu proyecto

Primero, debes comprimir la carpeta de tu proyecto. Puedes usar estos formatos: .zip, .tar, .tar.gz, .rar, etc.

No incluyas la carpeta node_modules, ya que eso se instalará más adelante.

2. Crea una carpeta para tu proyecto en cPanel

Ingresa a cPanel y abre el Administrador de Archivos.
Crea una nueva carpeta donde guardarás tu proyecto.

Ejemplo: test-nodejs-sn9 (puede estar en la carpeta principal de tu cuenta).

3. Sube y extrae tu proyecto

Entra a la carpeta que creaste.
Sube el archivo .zip (o el que comprimiste).
Una vez subido, haz clic derecho y selecciona “Extraer” para descomprimir los archivos.

4. Entra al módulo “Setup Node.js App”

Desde el panel principal de cPanel, busca y abre la opción:

“Setup Node.js App”

Presiona el botón “CREATE APPLICATION”.

5. Completa los datos de la aplicación

Aquí deberás llenar varios campos importantes:

También puedes crear una carpeta llamada logs y guardar ahí el archivo si prefieres tener todo ordenado.

6. Instala los paquetes del proyecto (NPM)

Una vez completados los campos anteriores:

Presiona el botón “Run NPM Install”.
Espera a que se instalen los paquetes. Esto puede tardar unos minutos.

7. Inicia la aplicación

Haz clic en “Run Application”.
Guarda los cambios presionando “Save”.

8. Abre tu aplicación

Lo puedes hacer desde el boton “OPEN”

O entrando a la url de tu sitio

¡Listo! Ahora puedes ingresar a la URL de tu dominio o subdominio y ver tu aplicación funcionando.

Problemas comunes y cómo solucionarlos

Error: Can't acquire lock for app

Esto significa que hay un archivo bloqueando la aplicación.

¿Cómo se soluciona?

En el Administrador de Archivos, entra a la carpeta llamada nodevenv (está en tu cuenta).

Verás una carpeta por cada proyecto.

Entra a la carpeta del proyecto que tiene el problema.
Busca un archivo llamado .lock y elimínalo.

Luego vuelve al panel de Node.js y reinicia la aplicación.

Queremos recordarte que si llegas a experimentar algún inconveniente en tu servicio, es fundamental que nos lo reportes a través de un ticket, idealmente incluyendo todos los detalles posibles y, si es factible, imágenes que nos ayuden a entender mejor la situación.

Ten en cuenta que, nuestro servicio de hosting no incluye acceso a terminal en cPanel. Por eso, contar con tu reporte nos permitirá evaluar con precisión el caso y entregarte la mejor solución disponible.

Puedes crear tu ticket haciendo clic aquí.