Node.js Apps en cPanel – Setup Node.js App

1. Requisitos previos

• Acceso a cPanel en hosting compartido
• Opcional: Acceso SSH para comandos avanzados
• Versiones soportadas: Node.js 10, 11 o superiores (según proveedor)

2. Acceder a la herramienta

Inicio → Herramientas → Software → Setup Node.js App

3. Crear una aplicación Node.js

1. Haz clic en CREATE APPLICATION

2. Configura:

   • Versión de Node.js: Elige la deseada (ej. 18.17)
   • Modo: Development (para pruebas) o Production
   • Application root: Ruta de la app (ej. /home/tuusuario/miapp – NO dentro de public_html)
   • Application URL: Selecciona dominio + URI (ej. tudominio.com/miapp)
   • Application startup file: Archivo principal (ej. app.js o server.js)

3. Haz clic en CREATE

   → La app se inicia automáticamente. Haz clic en OPEN para ver la página de prueba ("It Works!")

Nota: La app se ejecuta en un entorno virtual aislado. Cambios tardan ~1 min en aplicarse.

4. Configurar la aplicación (package.json)

1. Ve a File Manager → navega a la raíz de la app (ej. /home/tuusuario/miapp)

2. Crea un archivo nuevo: + Archivo → package.json

3. Edita y pega un JSON básico:

   {
   "name": "miapp",
   "version": "1.0.0",
   "description": "Mi app Node.js",
   "main": "app.js",
   "scripts": {
    "start": "node app.js"
   },
   "dependencies": {}
   }

4. Guarda

5. Vuelve a Setup Node.js App → edita la app (ícono lápiz) → haz clic en Run NPM Install para instalar dependencias iniciales

5. Instalar paquetes npm

1. En Setup Node.js App, edita la app → Run NPM Install (instala desde package.json)
2. Para paquetes específicos:
   • Usa SSH: source /home/tuusuario/nodevenv/miapp/18/bin/activate (ajusta versión)
   • Luego: cd /home/tuusuario/miapp y npm install express (ejemplo)
3. Reinicia la app después (ver sección 6)

Consejo: Siempre reinicia tras instalar paquetes para que surtan efecto.

6. Reiniciar, detener o eliminar la app

• Reiniciar: Edita la app (lápiz) → Restart
• Detener: Edita → Stop App
• Eliminar: Edita → Destroy (borra app y entorno)

Via SSH:

cloudlinux-selector restart --json --interpreter nodejs --app-root ~/miapp

7. Gestionar rutas y errores comunes

• En tu código (ej. app.js), define rutas para la URL base:

  app.get('/', (req, res) => res.send('¡Hola desde Node.js!'));

• Error "Cannot GET /": Asegúrate de que la ruta coincida con la Application URL y reinicia

8. Acciones rápidas desde la tabla de apps

9. Resumen rápido – Usos comunes