Como configurar uma aplicação Node.js pelo Node.js Selector do cPanel

Como configurar uma aplicação Node.js pelo Node.js Selector do cPanel

Olá, querido(a) cliente! Seja bem-vindo(a) ao seu espaço no mundo digital. Aqui na GeHost, acreditamos que tecnologia deve ser acessível, simples e poderosa — mesmo que você esteja começando agora. Hoje vamos aprender juntos como configurar uma aplicação Node.js usando o Node.js Selector no cPanel. É mais fácil do que parece, e eu vou te guiar passo a passo, como um verdadeiro Sensei da hospedagem.

Antes de começar: o que você precisa?

• Seu domínio já apontando para a hospedagem (ex: seu-site.com.br).
• Acesso ao cPanel da sua conta (você pode entrar no painel do cliente em painel.gehost.com.br).
• Seu aplicativo Node.js pronto, com os arquivos principais (como app.js, package.json, node_modules).

Dica do Sensei: Seu aplicativo precisa estar dentro da pasta public_html ou de uma subpasta nela (ex: public_html/meuapp). Isso é essencial!

Passo a passo: configurando seu Node.js com o Node.js Selector

1. Entre no cPanel
   Acesse o painel do cliente e faça login com seu usuário e senha. Após logar, você verá o painel principal do cPanel.
2. Encontre o Node.js Selector
   No cPanel, procure pela seção “Software” ou “Aplicações”. Lá, você verá uma ferramenta chamada “Node.js Selector”. Clique nela.
3. Crie uma nova instância Node.js
   Na tela do Node.js Selector, clique em “Criar nova instância”. Você verá um formulário com opções:
   • Nome da instância: Escolha um nome curto e claro (ex: meuapp).
   • Node.js Version: Escolha uma versão compatível com seu projeto (ex: 18.x, 20.x). Se não souber, use a versão mais recente disponível.
   • App Root: Selecione a pasta onde seu projeto está. Geralmente é public_html/meuapp ou public_html.
   • Startup File: Digite o nome do arquivo principal do seu app (ex: app.js ou server.js).
   Preencha os campos com cuidado e clique em “Criar”.
4. Verifique a instalação
   Após criar, o cPanel mostrará uma tela com o status da instância. Você verá algo como:
   • Nome: meuapp
   • Status: Ativo
   • URL: https://seu-site.com.br/meuapp (ou https://seu-site.com.br se estiver na raiz)
   Se tudo estiver certo, seu app está rodando!
5. Teste seu app
   Abra seu navegador e acesse a URL do seu app (ex: https://seu-site.com.br ou https://seu-site.com.br/meuapp). Se tudo estiver configurado corretamente, você verá a página inicial do seu aplicativo Node.js!

Se algo der errado: o que fazer?

Se o app não carregar ou aparecer um erro, aqui vão algumas dicas:

• Verifique se o arquivo de inicialização está correto (ex: app.js).
• Confira se todos os arquivos estão na pasta correta dentro de public_html.
• Verifique se o package.json tem a chave start definida corretamente (ex: "start": "node app.js").
• Se o erro persistir, entre em contato com nosso suporte (no painel do cliente) — estamos aqui para ajudar!

Importante: Todos os planos da GeHost incluem suporte técnico por 30 dias após a ativação. Se precisar de ajuda com configurações avançadas, não hesite em pedir!

Conclusão: você está no caminho certo!

Parabéns! Você acabou de colocar sua primeira aplicação Node.js no ar com sucesso. Cada grande projeto começa com um passo — e hoje, você deu esse passo com confiança. Continue aprendendo, criando e transformando ideias em realidade. E lembre-se: a GeHost está aqui com você, a cada passo.

Se você gostou deste guia, compartilhe com quem também está começando. E se tiver dúvidas, sempre pode voltar aqui — ou nos procurar no painel do cliente.

Com carinho,
Sensei da GeHost
*Grupo: G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)*