Como criar uma aplicação NodeJS no cPanel

Escrito por Jefferson André Voigt
Atualizado em 02/02/2026

Este tutorial explica como criar e executar uma aplicação Node.js utilizando o recurso Setup Node.js App no cPanel.

Passo 1 – Acessar o cPanel

Faça login no cPanel da sua hospedagem utilizando seu usuário e senha.

Passo 2 – Abrir o Setup Node.js App

  1. No cPanel, localize a seção Software.
  2. Clique em Setup Node.js App (Configurar NodeJS).

Passo 3 – Criar uma nova aplicação

  1. Clique em CRIAR APLICAÇÃO e preencha os campos abaixo.
  2. Versão do Node.js: Selecione a versão do Node.js compatível com sua aplicação. Recomenda-se escolher a versão correta desde o início para evitar problemas de compatibilidade.
  3. Modo da aplicação: Escolha Development para testes ou Production para aplicações em produção.
  4. Diretório/Raiz do aplicativo: Informe o diretório onde ficarão os arquivos da aplicação. A aplicação não pode ser criada diretamente na pasta /public_html.
  5. URL do aplicativo: Define o endereço pelo qual a aplicação será acessada via navegador, podendo ser um domínio, subdomínio ou uma pasta específica.
  6. Arquivo de inicialização: Informe o arquivo JavaScript principal da aplicação, como app.js, index.js ou server.js.
  7. Clique em CRIAR.

Passo 4 – Enviar os arquivos da aplicação

Após criar a aplicação, envie os arquivos do seu projeto Node.js para o diretório configurado, utilizando o Gerenciador de Arquivos do cPanel ou via FTP.

Passo 5 – Criar ou verificar o package.json

Certifique-se de que existe o arquivo package.json no diretório da aplicação, pois ele é necessário para a instalação das dependências.

Exemplo básico de package.json:

{
  "name": "minha-aplicacao",
  "version": "1.0.0",
  "main": "app.js",
  "scripts": {
    "start": "node app.js"
  }
}

Passo 6 – Instalar dependências

Na página da aplicação, utilize a opção Run NPM Install (Executar a instalação do NPM) para instalar automaticamente todas as dependências definidas no package.json.


Passo 7 – Reiniciar a aplicação

Após concluir a configuração e a instalação das dependências, clique em Restart para reiniciar a aplicação Node.js.

Passo 8 – Acessar a aplicação

Abra o navegador e acesse a URL configurada. Se tudo estiver correto, sua aplicação Node.js estará funcionando normalmente.

Este artigo foi útil? 1 usuários acharam isso útil