NVM na VPS: como instalar o Node.js e trocar de versão sem dor de cabeça

Tempo de leitura: 3 minutos

Um projeto pede Node.js 18, outro já exige o 22, e o pacote que vem no repositório da distribuição está desatualizado. Instalar e remover versões à mão vira bagunça rápido. O NVM (Node Version Manager) resolve isso: ele instala quantas versões do Node.js você quiser e troca entre elas com um comando.

Aplicações Node.js rodam muito bem numa VPS com recursos dedicados. Se você ainda não tem onde rodar isso, a Cloud VPS Brasil já entrega o servidor pronto.

Por que não usar o Node.js do apt

O pacote nodejs dos repositórios do Ubuntu e do Debian costuma estar várias versões atrás. Além disso, só permite uma versão por vez e instalar pacotes globais exige sudo, o que é ruim para a segurança.

Com o NVM, tudo fica na pasta do seu usuário, sem sudo.

Passo 1: instalar o NVM

Use o script oficial do projeto. Confira no repositório do NVM no GitHub qual é a versão mais recente e substitua no comando:

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

Recarregue o terminal para o comando ficar disponível:

source ~/.bashrc
nvm --version

Passo 2: instalar o Node.js

Para instalar a versão LTS (suporte de longo prazo), a recomendada para produção:

nvm install --lts

Para uma versão específica:

nvm install 20

Liste o que está instalado:

nvm ls

Passo 3: trocar de versão

nvm use 20
node -v

Para definir a versão padrão de todo terminal novo:

nvm alias default 20

Uma versão por projeto com o .nvmrc

Na pasta do projeto, crie um arquivo .nvmrc com a versão:

echo "20" > .nvmrc

Dentro da pasta, basta rodar nvm use e ele lê a versão do arquivo. Quem trabalha no projeto sempre usa a mesma versão.

Usando com o PM2

O PM2 mantém a aplicação rodando e reinicia se ela cair. Instale na versão do Node.js que você vai usar:

npm install -g pm2
pm2 start app.js --name minha-api
pm2 save
pm2 startup

O comando pm2 startup mostra uma linha com sudo e o caminho do Node.js do NVM. Copie e rode exatamente a linha mostrada, para o PM2 subir com o sistema. Mais detalhes em PM2 na VPS.

Atualizando o Node.js

Quando sair uma nova versão LTS:

nvm install --lts --reinstall-packages-from=current

Assim os pacotes globais, como o próprio PM2, vêm junto. Depois, rode pm2 update para o PM2 passar a usar a versão nova.

Problemas comuns

  • “nvm: command not found”: o terminal não recarregou o .bashrc. Feche e abra a sessão SSH.
  • Cron ou systemd não encontram o node: eles não carregam o NVM. Use o caminho completo, que você descobre com which node.
  • Cada usuário tem o seu NVM: o Node.js instalado pelo root não aparece para outro usuário.

Node.js em produção com desempenho

Com o NVM, cada projeto roda na versão certa e atualizar deixa de ser um risco. Na Cloud VPS Brasil você conta com Intel Xeon Gold, SSD NVMe, baixa latência, tráfego ilimitado, preço fixo em reais e suporte humano via WhatsApp e ticket. Fale com a equipe pelo WhatsApp e escolha o plano ideal para o seu projeto.