Como configurar múltiplas versões do Node.js para uma aplicação no cPanel
Olá, querido(a) cliente da GeHost! 😊
Se você está desenvolvendo um projeto com Node.js e precisa rodar versões diferentes em diferentes ambientes — ou até mesmo testar uma versão específica da sua aplicação — saiba que é possível sim! No cPanel, você pode gerenciar múltiplas versões do Node.js com facilidade. Vamos passo a passo, como se fosse um convite para aprender comigo, o seu Sensei da GeHost!
Antes de começar: o que você precisa saber
- Seu plano de hospedagem precisa ter suporte ao Node.js — e todos os planos da GeHost incluem isso.
- Não é necessário acesso root ou configurações avançadas. Tudo é feito pelo painel cPanel.
- Este guia é para quem já tem uma aplicação Node.js em execução ou está prestes a colocá-la no ar.
Passo a passo: como configurar múltiplas versões do Node.js
- Entre no seu painel cPanel
Acesse painel.gehost.com.br com suas credenciais. Se não se lembra, basta digitar seu e-mail e senha de acesso à conta. - Localize a ferramenta "Node.js" no cPanel
Após logar, procure na aba de "Software" ou "Desenvolvimento". Você vai ver uma opção chamada Node.js — clique nela. - Veja as versões disponíveis
Na tela do Node.js, você verá uma lista com as versões instaladas no servidor. A GeHost mantém várias versões atualizadas, como 16.x, 18.x, 20.x, etc. Você pode escolher qualquer uma delas para o seu projeto. - Escolha a versão para o seu projeto
Clique em “Gerenciar Versões” ou algo semelhante (pode variar levemente conforme a versão do cPanel). Lá, você pode ver todas as versões instaladas e escolher qual será usada para o seu site ou aplicação. - Defina a versão no diretório da sua aplicação
Cada aplicação Node.js geralmente está em uma pasta dentro depublic_htmlou em um subdomínio. No cPanel, você pode definir a versão do Node.js diretamente para aquela pasta.
Dica: Se você tem um projeto empublic_html/app1, vá até a ferramenta Node.js e selecione essa pasta ou seu domínio. Em seguida, escolha a versão do Node.js que deseja usar. - Salve e teste
Após escolher a versão, clique em “Salvar” ou “Aplicar”. O sistema já vai aplicar a configuração automaticamente. Agora, basta acessar seu site ou aplicação pelo navegador para verificar se está rodando com a versão correta.
Dica extra do Sensei
Se você tiver duas ou mais aplicações com versões diferentes do Node.js (ex: uma com 16.x e outra com 20.x), basta repetir o processo para cada pasta ou domínio, definindo a versão certa para cada um. O cPanel entende isso muito bem — é como ter vários motores diferentes em um mesmo carro!
Problemas comuns e como resolver
- “A versão não está aparecendo”: Pode ser que sua aplicação ainda não tenha sido reconhecida. Certifique-se de que o arquivo
package.jsonestá no diretório raiz da aplicação. - “Erro ao iniciar o servidor”: Verifique se o script
startnopackage.jsonestá correto. Exemplo:"start": "node index.js". - “Não sei qual versão usar”: Consulte seu desenvolvedor ou o documento de configuração do projeto. Se não souber, use a versão mais recente disponível — geralmente é a mais estável.
Quer ajuda extra?
Se precisar de apoio, o suporte da GeHost está aqui para você — e está incluso no seu plano. Basta entrar no painel do cliente e abrir um chamado. Nós respondemos com carinho, sempre que possível.
Seu projeto está no ar? Parabéns! 🎉 Você está cada vez mais perto de realizar seus sonhos com tecnologia. E lembre-se: a GeHost está com você, do início ao fim.
Com carinho,
Sensei da GeHost
*Grupo: G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)*