{"id":6297,"date":"2024-04-29T18:20:00","date_gmt":"2024-04-29T16:20:00","guid":{"rendered":"https:\/\/www.nicalia.com\/nicapedia\/guias\/cpanel\/desplegar-una-app-node-js-en-cpanel\/"},"modified":"2026-06-03T13:23:57","modified_gmt":"2026-06-03T11:23:57","slug":"desplegar-una-app-node-js-en-cpanel","status":"publish","type":"docs","link":"https:\/\/www.nicalia.com\/nicapedia\/desplegar-una-app-node-js-en-cpanel\/","title":{"rendered":"C\u00f3mo desplegar una app Node.js en cPanel paso a paso"},"content":{"rendered":"

Node.js es un entorno de ejecuci\u00f3n de JavaScript de c\u00f3digo 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\u00f3n.<\/p>\n\n

Node.js es especialmente eficiente para manejar m\u00faltiples solicitudes simult\u00e1neas gracias a su arquitectura basada en eventos y sin bloqueo de I\/O. Es uno de los entornos m\u00e1s populares entre desarrolladores por su ecosistema de paquetes npm y su capacidad de integrarse f\u00e1cilmente con otras tecnolog\u00edas.<\/p>\n\n

\u2139\ufe0f Node.js est\u00e1 disponible en todos los planes de hosting compartido de Nicalia.<\/strong> No necesitas un VPS ni servidor dedicado para desplegar aplicaciones Node.js.<\/p>\n\n\n\n\n

C\u00f3mo desplegar una App Node.js en cPanel: gu\u00eda paso a paso<\/h2>\n\n

Paso 1 \u2014 Acceder a Setup Node.js App<\/h3>\n\n

Inicia sesi\u00f3n en tu cuenta cPanel y busca \u00abSetup Node.js App\u00bb<\/strong> en la secci\u00f3n Software<\/strong>.<\/p>\n\n\n

\n \"Secci\u00f3n\n<\/figure>\n\n\n

Paso 2 \u2014 Crear una nueva aplicaci\u00f3n<\/h3>\n\n

Haz clic en \u00abCreate Application\u00bb<\/strong> para iniciar el asistente de configuraci\u00f3n.<\/p>\n\n\n

\n \"Pantalla\n<\/figure>\n\n\n

Paso 3 \u2014 Seleccionar la versi\u00f3n de Node.js<\/h3>\n\n

En el campo \u00abNode.js version\u00bb<\/strong>, selecciona la versi\u00f3n que necesita tu aplicaci\u00f3n. Elige siempre la versi\u00f3n LTS (Long Term Support) m\u00e1s reciente salvo que tu aplicaci\u00f3n requiera una versi\u00f3n espec\u00edfica por compatibilidad con sus dependencias.<\/p>\n\n\n

\n \"Selector\n<\/figure>\n\n\n

Paso 4 \u2014 Indicar la ruta de la aplicaci\u00f3n (Application root)<\/h3>\n\n

En el campo \u00abApplication root\u00bb<\/strong>, introduce la ruta del directorio donde tienes los archivos de tu aplicaci\u00f3n Node.js. Esta ruta es relativa al directorio home de tu cuenta \u2014 por ejemplo, si tus archivos est\u00e1n en \/home\/usuario\/miapp\/<\/code>, introduce simplemente miapp<\/code>.<\/p>\n\n

Si todav\u00eda no has subido los archivos, crea primero el directorio y sube el c\u00f3digo de la aplicaci\u00f3n por FTP o desde el Administrador de Archivos de cPanel.<\/p>\n\n\n

\n \"Campo\n<\/figure>\n\n\n

Paso 5 \u2014 Especificar la URL de la aplicaci\u00f3n<\/h3>\n\n

En el campo \u00abApplication URL\u00bb<\/strong>, especifica la URL desde la que se acceder\u00e1 a tu aplicaci\u00f3n. Puedes elegir:<\/p>\n\n

    \n
  • El dominio ra\u00edz: tudominio.com<\/code><\/li>\n
  • Un subdominio: app.tudominio.com<\/code><\/li>\n
  • Una ruta del dominio: tudominio.com\/miapp<\/code><\/li>\n<\/ul>\n\n\n
    \n \"Campo\n<\/figure>\n\n\n

    Paso 6 \u2014 Indicar el archivo de inicio (Application Startup File)<\/h3>\n\n

    En el campo \u00abApplication Startup File\u00bb<\/strong>, introduce el nombre del archivo JavaScript principal de tu aplicaci\u00f3n \u2014 el punto de entrada que Node.js ejecutar\u00e1 al arrancar. Debe tener extensi\u00f3n .js<\/code>. Los nombres m\u00e1s habituales son app.js<\/code>, server.js<\/code> o index.js<\/code>.<\/p>\n\n\n

    \n \"Campo\n<\/figure>\n\n\n

    Paso 7 \u2014 Crear la aplicaci\u00f3n<\/h3>\n\n

    Una vez rellenados todos los campos, haz clic en \u00abCreate\u00bb<\/strong> para crear la aplicaci\u00f3n. cPanel configurar\u00e1 el entorno Node.js y desplegar\u00e1 tu aplicaci\u00f3n.<\/p>\n\n

    Para verificar que todo funciona correctamente, abre el navegador y accede a la URL que configuraste. Si la aplicaci\u00f3n est\u00e1 activa, ver\u00e1s un mensaje indicando la versi\u00f3n de Node.js que est\u00e1s usando:<\/p>\n\n\n

    \n \"Mensaje\n<\/figure>\n\n\n\n\n\n

    Pasos siguientes tras desplegar la aplicaci\u00f3n<\/h2>\n\n
      \n
    • Instalar dependencias npm:<\/strong> si tu aplicaci\u00f3n usa paquetes de npm, necesitas instalarlos. Desde la pantalla de gesti\u00f3n de la aplicaci\u00f3n en cPanel, haz clic en \u00abRun NPM Install\u00bb<\/strong> para instalar las dependencias definidas en tu package.json<\/code>.<\/li>\n
    • Configurar variables de entorno:<\/strong> puedes a\u00f1adir variables de entorno desde la misma pantalla de gesti\u00f3n, en la secci\u00f3n \u00abEnvironment Variables\u00bb<\/strong>. \u00datil para credenciales, claves de API o configuraciones que no deben estar en el c\u00f3digo.<\/li>\n
    • Reiniciar la aplicaci\u00f3n:<\/strong> tras hacer cambios en el c\u00f3digo, usa el bot\u00f3n \u00abRestart\u00bb<\/strong> desde la pantalla de gesti\u00f3n para aplicar los cambios sin necesidad de recrear la aplicaci\u00f3n.<\/li>\n
    • Verificar los logs:<\/strong> si la aplicaci\u00f3n falla, revisa los logs de error desde cPanel o accede al archivo de log que cPanel genera autom\u00e1ticamente para cada aplicaci\u00f3n Node.js.<\/li>\n<\/ul>\n\n\n\n\n

      Errores frecuentes al desplegar apps Node.js en cPanel<\/h2>\n\n

      La URL de la aplicaci\u00f3n devuelve error 503 o \u00abApplication Not Started\u00bb<\/h3>\n

      La aplicaci\u00f3n no se ha iniciado correctamente. Ve a la pantalla de gesti\u00f3n en Setup Node.js App<\/em> y verifica que el estado es \u00abRunning\u00bb. Si no lo est\u00e1, haz clic en \u00abStart App\u00bb<\/strong>. Tambi\u00e9n puede ocurrir que el archivo Startup File no existe en la ruta indicada \u2014 verifica que el archivo app.js<\/code> (o el que hayas configurado) est\u00e1 en el directorio de Application root<\/em>.<\/p>\n\n

      Error al ejecutar npm install \u2014 m\u00f3dulos no encontrados<\/h3>\n

      El archivo package.json<\/code> no est\u00e1 en el directorio ra\u00edz de la aplicaci\u00f3n, o hay un error en sus dependencias. Verifica que package.json<\/code> existe en el Application root<\/em> y que los nombres de los paquetes son correctos. Si el error persiste, revisa el log de npm que cPanel muestra tras la instalaci\u00f3n.<\/p>\n\n

      La aplicaci\u00f3n funciona en local pero no en cPanel<\/h3>\n

      Las causas m\u00e1s frecuentes son: (1) la versi\u00f3n de Node.js seleccionada en cPanel no coincide con la que usaste en local \u2014 usa node --version<\/code> en local y selecciona la misma en cPanel; (2) alg\u00fan m\u00f3dulo nativo (que requiere compilaci\u00f3n) no es compatible con el entorno de cPanel; (3) la aplicaci\u00f3n intenta escuchar en un puerto fijo \u2014 en cPanel, el puerto lo asigna el sistema autom\u00e1ticamente a trav\u00e9s del socket de la aplicaci\u00f3n.<\/p>\n\n

      Los cambios en el c\u00f3digo no se reflejan en la aplicaci\u00f3n<\/h3>\n

      Node.js no recarga autom\u00e1ticamente el c\u00f3digo al modificar archivos. Tras cada cambio debes reiniciar la aplicaci\u00f3n desde el bot\u00f3n \u00abRestart\u00bb<\/strong> en la pantalla de gesti\u00f3n de Setup Node.js App.<\/p>\n\n\n\n\n

      Preguntas frecuentes sobre Node.js en cPanel<\/h2>\n\n

      \u00bfPuedo usar Node.js en mi hosting compartido de Nicalia?<\/h3>\n

      S\u00ed. Node.js est\u00e1 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\u00f3n Software \u2192 Setup Node.js App<\/em> de cPanel.<\/p>\n\n

      \u00bfQu\u00e9 versiones de Node.js est\u00e1n disponibles en cPanel?<\/h3>\n

      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\u00eda. Para conocer las versiones actuales del servidor de Nicalia, contacta con el soporte o cons\u00faltalo directamente en el selector al crear la aplicaci\u00f3n.<\/p>\n\n

      \u00bfPuedo tener varias aplicaciones Node.js en el mismo hosting?<\/h3>\n

      S\u00ed. Puedes crear m\u00faltiples aplicaciones Node.js en el mismo hosting, cada una en su propio directorio y con su propia URL (dominio, subdominio o ruta). Cada aplicaci\u00f3n funciona de forma independiente con su propia versi\u00f3n de Node.js y sus propias dependencias.<\/p>\n\n

      \u00bfC\u00f3mo actualizo mi aplicaci\u00f3n Node.js despu\u00e9s de desplegarla?<\/h3>\n

      Sube los archivos actualizados al directorio de la aplicaci\u00f3n por FTP o desde el Administrador de Archivos de cPanel. Si has a\u00f1adido o modificado dependencias npm, ejecuta \u00abRun NPM Install\u00bb<\/strong> desde la pantalla de gesti\u00f3n. Luego haz clic en \u00abRestart\u00bb<\/strong> para aplicar los cambios.<\/p>\n\n

      \u00bfPuedo usar Express, Fastify u otros frameworks con Node.js en cPanel?<\/h3>\n

      S\u00ed. Puedes usar cualquier framework Node.js que sea compatible con tu versi\u00f3n: Express, Fastify, Koa, Hapi, etc. Solo necesitas incluirlos como dependencias en tu package.json<\/code> y ejecutar npm install<\/em> desde la pantalla de gesti\u00f3n de la aplicaci\u00f3n en cPanel.<\/p>","protected":false},"excerpt":{"rendered":"

      Node.js es un entorno de ejecuci\u00f3n de JavaScript de c\u00f3digo 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\u00f3n. Node.js es especialmente eficiente para manejar m\u00faltiples […]<\/p>\n","protected":false},"author":4,"featured_media":0,"parent":8658,"menu_order":74,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"doc_badge":[],"class_list":["post-6297","docs","type-docs","status-publish","hentry","no-post-thumbnail"],"acf":[],"author_avatar":"https:\/\/secure.gravatar.com\/avatar\/4471485c4e49f46218d6b6d125f80f4cde1f86f045fd896202eefddaf4d4510a?s=96&d=mm&r=g","author_name":"Francisco Garvi","_links":{"self":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/6297","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/comments?post=6297"}],"version-history":[{"count":8,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/6297\/revisions"}],"predecessor-version":[{"id":10041,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/6297\/revisions\/10041"}],"up":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/8658"}],"wp:attachment":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/media?parent=6297"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/doc_tag?post=6297"},{"taxonomy":"doc_badge","embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/doc_badge?post=6297"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}