Como instalar uma versão específica do Node.js em um VPS

Como instalar uma versão específica do Node.js no seu VPS

Se seu projeto exige uma versão exata do Node.js (por exemplo, porque o sistema pede "Node 18" ou "Node 20 LTS"), a forma mais segura e mais usada no mercado é instalar o NVM (Node Version Manager). Com ele você troca de versão em segundos, sem bagunçar o sistema operacional do seu VPS. Vamos passo a passo, com calma. 🧘

Este guia vale para VPS com acesso via terminal (SSH), com Linux (Ubuntu/Debian ou CentOS/AlmaLinux). Se você tem um plano de hospedagem compartilhada (cPanel), o processo é diferente — nesse caso, fale com o suporte pelo painel para saber a forma correta de definir a versão do Node no seu ambiente.

1. Acesse seu VPS via SSH

Abra o terminal do seu computador e conecte no servidor com o usuário e o endereço que você recebeu na entrega do seu VPS:

ssh usuario@seu-servidor

Digite a senha (ou use sua chave SSH, se configurou uma) e pronto, você está dentro do servidor.

2. Instale o NVM

O NVM é um script leve que gerencia várias versões do Node no mesmo servidor, sem conflito. Rode o comando abaixo:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

Depois, feche e abra o terminal novamente (ou rode o comando abaixo) para o sistema reconhecer o NVM:

source ~/.bashrc

Dica da Sensei: se depois de instalar o comando nvm não for reconhecido, tente rodar source ~/.profile ou reabrir a sessão SSH. É o erro mais comum nessa etapa e é rapidinho de resolver.

3. Confirme que o NVM está funcionando

Rode:

nvm --version

Se aparecer um número de versão (tipo 0.39.7), está tudo certo e você já pode seguir para a instalação do Node.

4. Veja quais versões do Node estão disponíveis

Quer ver a lista de versões que podem ser instaladas?

nvm list-remote

Se você só precisa da versão LTS (a mais estável, recomendada para produção), pode pular direto para o próximo passo.

5. Instale a versão específica que você precisa

Agora sim, o passo principal. Troque 18 pelo número da versão que seu projeto pede:

1. Para instalar uma versão exata:

   nvm install 18.20.4

2. Para instalar apenas a versão "major" mais recente da linha 18:

   nvm install 18

3. Para instalar a versão LTS mais recente disponível:

   nvm install --lts

6. Defina essa versão como padrão

Depois de instalada, diga ao sistema para sempre usar essa versão quando você abrir uma nova sessão:

nvm use 18.20.4
nvm alias default 18.20.4

7. Confira se deu tudo certo

Confirme a versão ativa do Node e do gerenciador de pacotes NPM:

node -v
npm -v

Se aparecer o número da versão que você escolheu, parabéns — está tudo pronto para rodar sua aplicação! 🎉

Trocando de versão depois

Se no futuro você precisar testar outra versão (ou voltar para uma anterior), basta repetir o passo 5 e 6 com o novo número. O NVM guarda todas as versões já instaladas, então trocar entre elas é instantâneo:

nvm use 20.11.0

Rodando sua aplicação com um gerenciador de processos

Para aplicações Node em produção, é recomendado usar um gerenciador de processos (como o PM2) para manter sua aplicação no ar mesmo após reiniciar o servidor. Isso, porém, é um passo à parte — se precisar de ajuda com isso, é só chamar o suporte.

Importante: antes de atualizar a versão do Node em um ambiente que já está em produção, teste a nova versão em um ambiente separado (ou fora do horário de pico). Trocar a versão do Node pode afetar dependências do seu projeto.

Ficou com dúvida em algum passo?

Sem problemas — configuração de VPS pode ter suas particularidades dependendo do seu projeto. Se travar em algum comando ou mensagem de erro, entre em contato com o suporte da GeHost pelo painel.gehost.com.br que a gente te ajuda a destravar. 💛