Como configurar um ambiente Node.js no cPanel para rodar uma aplicação própria

Como configurar um ambiente Node.js no cPanel para rodar sua aplicação própria

Olá, querido(a) desenvolvedor(a) ou entusiasta da web! Seja bem-vindo(a) ao seu novo lar digital na GeHost. Aqui, você não precisa de máquinas virtuais, root ou configurações complexas — só um bom coração, um bom código e um pouquinho de paciência. Vamos juntos montar seu ambiente Node.js no cPanel, passo a passo, como se fosse uma receita de bolo caseiro: simples, gostoso e feito com carinho.

Antes de começar: entenda o que você vai fazer

Node.js é uma plataforma que permite rodar código JavaScript fora do navegador — perfeito para criar servidores, APIs e aplicativos web dinâmicos. Na GeHost, você pode executar aplicações Node.js em seus planos de hospedagem cPanel, desde que o plano permita.

Dica do Sensei: Seu plano precisa ter suporte a Node.js. Confira isso no painel do cliente — no menu "Serviços", veja se "Node.js" aparece como opção.

Passo a passo: montando seu ambiente Node.js

1. Entre no cPanel

   Use seu login e senha para acessar o painel. Acesse: painel.gehost.com.br e clique em "cPanel".

   
2. Localize a ferramenta Node.js

   No cPanel, procure pela seção "Software" ou "Aplicações". Você vai encontrar uma ferramenta chamada Node.js (geralmente com ícone de um símbolo de JavaScript).

   
3. Crie um novo ambiente Node.js

   Clique em Node.js. Em seguida, clique em Gerenciar Ambientes. Agora, clique em Adicionar Ambiente.

   Na tela que aparecer, escolha o nome do seu ambiente (ex: meuapp), selecione a versão do Node.js (use a mais recente disponível — geralmente a 18 ou 20). Depois, defina o diretório onde o código será executado (normalmente public_html/meuapp).

   Após configurar, clique em Salvar.

4. Envie seu código

   Com o ambiente criado, agora é hora de colocar seu código. Use o Gerenciador de Arquivos para navegar até o diretório escolhido (ex: public_html/meuapp).

   

   Arraste e solte os arquivos da sua aplicação (com o server.js ou app.js principal, e o package.json) para essa pasta.

5. Defina o arquivo de entrada

   Volte ao painel do Node.js. Na lista de ambientes, clique em Gerenciar ao lado do ambiente que você criou.

   Na seção "Arquivo de Entrada", digite o nome do arquivo principal da sua aplicação — por exemplo: server.js ou app.js.

   Salve as alterações.

6. Instale as dependências

   Seu projeto depende de pacotes como express, mongoose, etc. Para instalar, vá até o terminal do cPanel (em "Terminal") ou use a opção "Instalar Dependências" no painel do Node.js.

   Se não houver essa opção, abra o terminal, acesse o diretório do seu app e execute:

   npm install

   Isso baixará todas as dependências listadas no package.json.

7. Inicie o servidor

   Volte ao painel do Node.js. Agora, clique em Iniciar ao lado do seu ambiente.

   Se tudo estiver certo, o servidor será iniciado e você verá uma mensagem de sucesso.

8. Teste sua aplicação

   Abra seu navegador e acesse: http://seudominio.com:3000 (ou a porta que você configurou).

   Se você vir uma mensagem como "Hello World" ou a página da sua aplicação, parabéns! Você acaba de rodar um servidor Node.js no cPanel com sucesso!

Dicas do Sensei

• Use sempre o package.json — ele é o coração da sua aplicação. Sem ele, o Node.js não sabe o que instalar.
• Evite usar portas como 80 ou 443 — o cPanel gerencia isso por trás. Use portas como 3000, 3001, etc.
• Se der erro, verifique: se o arquivo de entrada está certo, se o package.json tem o script "start", se o código tem erros de sintaxe.
• Use o log — no painel do Node.js, há uma aba "Logs". Abra para ver mensagens de erro detalhadas.

Quer ajuda extra?

Se algo não funcionar como esperado, não se preocupe! A GeHost está aqui para você. Entre em contato com nosso suporte — ele está disponível por 30 dias após a entrega, e é feito com carinho por pessoas reais.

Se precisar de um orçamento, ou quiser saber mais sobre planos, acesse: gehost.com.br.

Dados da empresa (para fins fiscais)

Se precisar de nota fiscal ou dados para emissão, confira seu contrato ou fatura. A razão social é: G e Soluções e Eventos LTDA, CNPJ: 46.647.904/0001-04.

Formas de pagamento: Cartão de Crédito (via Stripe ou PayPal) ou Pix (via InfoPago).

Que sua aplicação cresça com amor, como uma planta bem cuidada. Até a próxima, desenvolvedor(a)!