Cómo desplegar Node.js en cPanel sobre tu VP

Sí, puedes correr Node.js en cPanel sin instalar nada por consola. cPanel incluye desde hace años la herramienta nativa Setup Node.js App que permite desplegar aplicaciones Node sobre Phusion Passenger en pocos clics, con gestión de versiones de Node, variables de entorno, dependencias npm y arranque automático del proceso. Esta guía es un tutorial práctico para desplegar Node.js en cPanel sobre tu VPS paso a paso, pensada para desarrolladores y agencias en México, Colombia, Argentina, Chile, Perú, Ecuador, Uruguay, Guatemala, Panamá, Venezuela y toda Latinoamérica.

El VPS con cPanel de x5 servers viene con cPanel y WHM preinstalados, licenciados y operativos, en modalidad no gestionada: tú despliegas tu aplicación Node desde el panel con autonomía total y acceso root completo. Si en algún punto necesitas que un sysadmin se encargue de configuraciones avanzadas, hardening o monitoreo proactivo, contratas adicionalmente nuestro servicio de administración de servidores y cobramos solo las tareas puntuales que necesites.

¿Se puede correr Node.js en cPanel?

Sí. cPanel soporta Node.js de forma nativa mediante el módulo Setup Node.js App, disponible bajo la sección Software del panel cPanel. La herramienta usa Phusion Passenger como gestor de procesos y permite correr Node 14, 16, 18, 20 y 22 LTS según la disponibilidad del servidor. No necesitas instalar nada manualmente por SSH ni configurar systemd ni PM2 para empezar — Passenger se encarga del ciclo de vida del proceso, reinicio automático y manejo de logs.

Esta integración convierte a cPanel en una plataforma viable para desplegar APIs REST, aplicaciones Express, microservicios, dashboards Next.js en modo standalone, bots Telegram/Discord, scrapers programados y cualquier app Node que escuche en un puerto interno. Para casos que necesitan control total (Docker, Kubernetes, builds compilados con esbuild en producción), un VPS Linux sin panel sigue siendo la mejor opción, pero el 90% de los proyectos Node de agencias y devs LATAM corren perfectamente sobre el cPanel de un VPS.

Setup Node.js App: la herramienta nativa de cPanel

La pieza clave es la sección Setup Node.js App dentro de cPanel. Desde ahí creas, configuras, arrancas y detienes tus aplicaciones Node.js cPanel sin tocar consola. Cada aplicación queda asociada a un dominio o subdominio, a una carpeta dentro de tu home, a un puerto interno gestionado por Passenger y a una versión específica de Node.

La pantalla principal te muestra todas las aplicaciones Node creadas, su estado (Started / Stopped), versión de Node activa, ruta de la aplicación y dominio asociado. Cada app tiene controles individuales para reiniciar, detener, ejecutar comandos npm o entrar al entorno virtual de Node (similar a un virtualenv de Python pero para Node).

Requisitos del VPS para correr Node.js en LATAM

Antes de desplegar tu app, conviene saber qué recursos mínimos pide Node sobre cPanel para que rinda bien con tráfico real desde Latinoamérica:

• RAM mínima recomendada: 2 GB para apps pequeñas (Express con API REST), 4 GB para Next.js en modo SSR o apps con cache en memoria, 8 GB+ para producción con múltiples workers.
• Node 18 LTS o superior: Node 14 está descontinuado y Node 16 dejó de recibir soporte en septiembre de 2023. Para 2026 lo recomendable es Node 20 o 22 LTS.
• Acceso SSH habilitado: aunque la mayoría se hace por panel, para clonar repos desde GitHub o GitLab necesitas SSH al menos una vez.
• NVMe: el almacenamiento NVMe acelera npm install de forma notoria — instalar dependencias pesadas (Next.js, Nest, Strapi) sobre SSD tradicional puede tardar 3-5 veces más.
• Latencia hacia LATAM: un datacenter en EE.UU. (Seattle o Tampa) da latencia 40-80 ms hacia México, Colombia, Perú y resto de la región — suficiente para la mayoría de APIs.

¿Necesitas un VPS para tu app Node.js? Revisa los planes de VPS con cPanel preinstalado de X5 Servers — cPanel y WHM licenciados, NVMe, datacenter EE.UU., factura en USD para toda LATAM.

Despliegue paso a paso de una app Node.js en cPanel

Este es el flujo completo para llevar una aplicación Node desde tu repositorio local hasta producción en tu VPS con cPanel. Aplica para Express, Fastify, Next.js standalone, Nest, Strapi, Adonis o cualquier app que escuche en un puerto.

Paso 1 — Subir el código a la carpeta de la aplicación

Crea una carpeta dentro de tu home, por ejemplo /home/usuario/apps/mi-api. Tienes tres caminos para subir el código:

• Git desde Terminal de cPanel: abre la sección Terminal en cPanel, navega a la carpeta y haz git clone https://github.com/tu-usuario/tu-repo.git . Es lo más limpio para proyectos con CI/CD.
• File Manager: sube un .zip con el código y descomprime desde el panel. Útil para apps puntuales sin Git.
• SFTP/SSH: usa Filezilla o el cliente que prefieras. Recomendado para sincronizar carpetas grandes o builds previas.

Importante: no subas la carpeta node_modules. Se generará en el servidor con npm install dentro de Setup Node.js App.

Paso 2 — Crear la aplicación en Setup Node.js App

Entra a cPanel → Setup Node.js App → botón Create Application. Llena los campos:

• Node.js version: elige 20 LTS o 22 LTS.
• Application mode: Production para sitios reales, Development para staging.
• Application root: ruta relativa al home, por ejemplo apps/mi-api.
• Application URL: dominio o subdominio que apuntará a tu app (ej. api.tudominio.com o tudominio.com/api).
• Application startup file: archivo que arranca la app, normalmente app.js, server.js, index.js o dist/main.js según el framework.
• Passenger port: cPanel asigna un puerto interno automáticamente (entre 30000-40000). Tu app debe leer el puerto desde process.env.PORT.

Click en Create. cPanel genera el entorno virtual de Node, configura Passenger y crea el archivo .htaccess necesario en la carpeta pública para que el dominio enrute correctamente hacia tu app.

Paso 3 — Instalar dependencias con npm

Una vez creada la app, vuelves a la lista de aplicaciones. Encuentra tu app y click en el ícono de edición. Verás un botón Run NPM Install que ejecuta npm install dentro del entorno virtual de Node correcto. Esto genera node_modules a partir de tu package.json.

Si necesitas ejecutar comandos npm específicos (build de Next.js, generación de prisma client, migraciones de TypeORM), copia el comando que cPanel te muestra al final del editor — algo como source /home/usuario/nodevenv/apps/mi-api/20/bin/activate && cd /home/usuario/apps/mi-api — pégalo en Terminal y ya estás dentro del entorno correcto para correr npm run build, npx prisma migrate deploy o lo que necesites.

Paso 4 — Configurar variables de entorno

En la misma pantalla de edición de la aplicación tienes la sección Environment variables. Aquí configuras DATABASE_URL, API_KEYS, NODE_ENV=production, JWT_SECRET y cualquier variable que tu app espere. Estas variables se inyectan automáticamente en process.env cuando Passenger arranca tu app.

No subas .env al repositorio: usa siempre el panel para configurar las variables sensibles en producción. Para variables públicas (URLs, flags de feature) puedes mantener un .env versionado.

Paso 5 — Arrancar la aplicación

Click en Start App. Passenger lanza el proceso Node, asocia el puerto interno con el dominio configurado y empieza a servir tráfico. Visita la URL pública de tu app y deberías ver tu API o frontend funcionando.

Si la app no responde, revisa el archivo stderr.log y stdout.log dentro de la carpeta /home/usuario/apps/mi-api/ — ahí Passenger escribe todo lo que tu app imprime y los errores de arranque.

Gestionar dependencias, npm y variables de entorno

El día a día de una app Node.js cpanel en producción se resume en tres acciones repetidas: actualizar código, instalar nuevas dependencias y reiniciar la app cuando algo cambia. Estas son las recomendaciones prácticas que aprendimos atendiendo devs latinoamericanos:

• Actualizar código con git pull: entra a Terminal, ve a la carpeta de la app y haz git pull origin main. Tras el pull, vuelve a Setup Node.js App y click en Restart.
• npm install de nuevas dependencias: añade la dependencia al package.json en local, haz commit y push, en el servidor haz git pull y luego Run NPM Install desde el panel.
• Reinicio manual: el botón Restart en cPanel reinicia limpiamente el proceso Passenger. Alternativa por consola: touch tmp/restart.txt dentro de la carpeta de la app fuerza el reinicio.
• Logs: los archivos stderr.log y stdout.log son tus mejores amigos. Para apps con mucho tráfico, agrega un logger estructurado como pino o winston y rota los logs con logrotate vía cron.
• Builds de producción: apps Next.js, Nest o Vite necesitan npm run build antes del arranque. Hazlo desde Terminal con el entorno virtual activado.

Passenger: el runtime que cPanel usa por debajo

Phusion Passenger es el process manager que cPanel usa para correr aplicaciones Node, Python y Ruby. Cuando un visitante llega a tu dominio, Apache o LiteSpeed reciben la petición, ven el .htaccess de la carpeta pública que apunta a Passenger, y Passenger arranca o reutiliza un proceso Node corriendo tu app en el puerto interno asignado.

Esto significa que no necesitas PM2 sobre Setup Node.js App — Passenger ya hace el trabajo de PM2: levanta procesos, los mantiene vivos, los reinicia ante crashes, gestiona la concurrencia con un pool de workers, controla la memoria y cierra procesos inactivos para ahorrar RAM. Si vienes del mundo de DigitalOcean o Hetzner sin panel, esto es lo equivalente a tener PM2 + Nginx reverse proxy preconfigurados.

Para apps que necesitan más control (workers concurrentes, cluster mode, cron jobs internos, websockets persistentes a escala), un VPS Linux sin panel con PM2 sigue siendo más flexible — pero pagas con la complejidad de mantener todo manual.

Configurar dominio, subdominio y SSL para tu app Node

Tienes tres patrones comunes para exponer una app Node desde cPanel:

• Subdominio dedicado (recomendado): crea api.tudominio.com desde la sección Domains de cPanel, apunta el Application URL a ese subdominio. Es lo más limpio para APIs públicas.
• Subcarpeta del dominio principal: tudominio.com/api. Útil si tu frontend y API comparten dominio para evitar problemas CORS.
• Dominio adicional: si tu cuenta cPanel soporta múltiples dominios (lo cual en el VPS sí, en compartido depende del plan), crea un Addon Domain y enrutas la app ahí.

Para el SSL usa AutoSSL de cPanel que genera certificados Let’s Encrypt automáticamente para todos los dominios y subdominios de la cuenta. La renovación es automática cada 90 días. Si necesitas un certificado wildcard o EV, instálalo manualmente desde SSL/TLS.

Cuándo el VPS no administrado no es para ti

Honestidad ante todo: un VPS con cPanel no administrado es ideal cuando tienes un dev o agencia detrás del proyecto. Si te encuentras en cualquiera de estos escenarios, conviene contratar adicionalmente nuestro servicio de administración:

• No tienes equipo técnico y necesitas que alguien instale, configure y mantenga la app Node.
• Quieres hardening de seguridad: configuración de firewall avanzado, fail2ban, monitoreo proactivo, alertas 24/7.
• Migraciones complejas desde otro servidor con base de datos, archivos y configuración de DNS.
• Optimización de PHP-FPM, MySQL, Redis o servicios que tu stack Node consume internamente.
• Auditoría de rendimiento o resolución de problemas puntuales que requieren un sysadmin con experiencia cPanel.

¿No quieres meter mano al servidor? Contrata el VPS con cPanel y suma nuestro servicio de administración de servidores. Cotizamos solo las tareas que necesitas, sin tarifa mensual inflada.

Preguntas frecuentes sobre Node.js en cPanel

¿Qué versiones de Node.js soporta cPanel en 2026?

Las versiones disponibles dependen de la actualización del servidor, pero típicamente cPanel ofrece Node 14, 16, 18, 20 y 22. Para proyectos nuevos en 2026 lo recomendable es Node 20 LTS (soporte hasta abril 2026) o Node 22 LTS (soporte hasta abril 2027). Node 16 y anteriores ya no reciben actualizaciones de seguridad.

¿Puedo correr Next.js en cPanel?

Sí. Next.js corre perfectamente en cPanel sobre Setup Node.js App, en dos modalidades: como app standalone con next start tras correr npm run build, o exportado como sitio estático con next export si tu app no usa SSR. Para SSR completo con muchas rutas dinámicas, asegúrate de tener al menos 4 GB de RAM en el VPS.

¿Necesito PM2 si uso Setup Node.js App?

No. Phusion Passenger (el motor detrás de Setup Node.js App) cumple la función de PM2: mantiene el proceso vivo, reinicia automáticamente ante crashes, gestiona el pool de workers y controla la memoria. PM2 es útil si pasas a un VPS Linux sin panel, no si usas cPanel.

¿Cómo conecto mi app Node.js a MySQL en cPanel?

Crea la base de datos desde MySQL Databases en cPanel, crea un usuario, asígnale privilegios y usa esos datos de conexión en tu app con el driver mysql2 o better-sqlite3 según el caso. La conexión es por localhost porque MySQL corre en el mismo servidor. Para PostgreSQL, cPanel también ofrece PostgreSQL Databases con el mismo flujo.

¿Cuánta RAM consume una app Node.js promedio?

Una API Express simple consume 80-150 MB. Una app Next.js en SSR consume 200-400 MB en idle y puede picar a 800 MB-1 GB bajo carga. Una app Nest con TypeORM y muchas migraciones puede arrancar en 300-500 MB. Calcula el doble de lo que consume en tu laptop para producción con tráfico real.

¿Puedo correr múltiples apps Node.js en un solo VPS con cPanel?

Sí. Cada app vive en su carpeta, su puerto interno y su dominio o subdominio. Un VPS con 8 GB de RAM puede correr cómodamente 4-6 apps Node de tamaño medio. Para más apps simultáneas conviene escalar a un dedicado.

¿Se puede usar Docker dentro de un VPS con cPanel?

Sí, pero requiere instalación manual y conocimiento de Linux. cPanel no integra Docker nativamente — necesitas habilitar Docker a nivel SO desde root, lo cual no rompe cPanel pero queda fuera del soporte de plataforma. Si Docker es central para tu proyecto, mejor usa un VPS Linux sin panel o un servidor dedicado Proxmox.

¿Qué hago si mi app Node.js no arranca tras el deploy?

Revisa en orden: (1) que el archivo de arranque esté bien declarado en Setup Node.js App, (2) los logs stderr.log y stdout.log en la carpeta de la app, (3) que las variables de entorno estén configuradas, (4) que npm install haya terminado sin errores, (5) que tu app lea el puerto desde process.env.PORT y no use un puerto hardcoded como 3000.

Plan de acción — empezar hoy

Si vas a desplegar tu primera app Node.js en cPanel sobre un VPS de X5 Servers, este es el camino más corto:

1. Contrata un VPS con cPanel apropiado para tu carga (mínimo 2 GB RAM para empezar, 4 GB si usas Next.js).
2. Recibe credenciales (24h tras pago confirmado), accede a cPanel y crea tu cuenta de usuario.
3. Sube tu código por Git o SFTP a la carpeta apps/mi-proyecto.
4. Configura la app desde Setup Node.js App con Node 20 o 22 LTS.
5. Configura variables de entorno y corre npm install desde el panel.
6. Activa SSL con AutoSSL para tu dominio o subdominio.
7. Arranca la app y verifica que responda en producción.

¿Necesitas ayuda eligiendo el VPS adecuado para tu proyecto Node.js?
Habla con un asesor comercial por WhatsApp +1 786 744-1279 o escríbenos a info@x5servers.com. Si prefieres que el equipo de X5 te configure todo, suma nuestro servicio de administración de servidores y cobramos solo las tareas puntuales que necesites.