Hospedagem & cPanel 6 visualizações

Como configurar múltiplas versões do Node.js para uma aplicação no cPanel

Ver no WHMCS

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

  1. 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.
  2. Tela de login do cPanel com campos de usuário e senha
  3. 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.
  4. Painel inicial do cPanel com a ferramenta Node.js destacada na seção de Software
  5. 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.
  6. 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.
  7. Defina a versão no diretório da sua aplicação
    Cada aplicação Node.js geralmente está em uma pasta dentro de public_html ou 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 em public_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.
  8. 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.json está no diretório raiz da aplicação.
  • “Erro ao iniciar o servidor”: Verifique se o script start no package.json está 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)*

Precisa de Ajuda?

Nossa equipe está pronta para resolver suas dúvidas.