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.