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 pastapublic_htmlou de uma subpasta nela (ex:public_html/meuapp). Isso é essencial!
Passo a passo: configurando seu Node.js com o Node.js Selector
- 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.
- 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.
- 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/meuappoupublic_html. - Startup File: Digite o nome do arquivo principal do seu app (ex:
app.jsouserver.js).
- Nome da instância: Escolha um nome curto e claro (ex:
- 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(ouhttps://seu-site.com.brse estiver na raiz)
- Nome:
- Teste seu app
Abra seu navegador e acesse a URL do seu app (ex:https://seu-site.com.brouhttps://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
startdefinida 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)*