{
  "schemaVersion": "1.0",
  "path": "/guias/vps/instalar-node-nvm-vps",
  "url": "https://streethosting.com.br/guias/vps/instalar-node-nvm-vps",
  "markdownUrl": "https://streethosting.com.br/guias/vps/instalar-node-nvm-vps.md",
  "jsonUrl": "https://streethosting.com.br/guias/vps/instalar-node-nvm-vps.json",
  "title": "Como instalar o Node na VPS com o nvm e gerenciar versões",
  "description": "Use o nvm para instalar e alternar entre versões do Node na VPS sem conflito. Ideal para rodar bots e APIs que pedem versões diferentes, com troca rápida e sem quebrar nada.",
  "category": "vps",
  "topics": [
    "deploy"
  ],
  "difficulty": "intermediario",
  "datePublished": "2026-06-17",
  "dateModified": "2026-06-17",
  "readingMinutes": 3,
  "h1": "Instalar o Node na VPS com o nvm",
  "excerpt": "Projetos diferentes pedem versões diferentes do Node. O nvm resolve isso instalando e alternando entre versões num comando, sem bagunçar o sistema nem exigir privilégio de root.",
  "author": "Equipe StreetHosting",
  "wordCount": 462,
  "categoryLabel": "VPS",
  "topicLabels": [
    "Deploy e execução de apps"
  ],
  "primaryKeyword": "instalar node nvm vps",
  "secondaryKeywords": [
    "nvm gerenciar versoes node",
    "node version manager vps",
    "trocar versao node por projeto"
  ],
  "toc": [
    {
      "id": "por-que-nvm",
      "label": "Por que usar o nvm"
    },
    {
      "id": "instalar",
      "label": "Instalar o nvm"
    },
    {
      "id": "versoes",
      "label": "Instalar versões"
    },
    {
      "id": "producao",
      "label": "Versão em produção"
    },
    {
      "id": "boas-praticas",
      "label": "Boas práticas"
    }
  ],
  "faqs": [
    {
      "question": "Por que não instalar o Node direto pelo sistema?",
      "answer": "Você pode, mas fica preso a uma versão e a troca é trabalhosa. O nvm permite ter várias versões instaladas e alternar num comando, ideal quando projetos diferentes pedem versões diferentes."
    },
    {
      "question": "O nvm precisa de root?",
      "answer": "Não. Ele instala o Node no diretório do usuário, sem privilégio de administrador. Isso é mais seguro e evita conflito com pacotes do sistema, além de facilitar separar ambientes por usuário."
    },
    {
      "question": "Como garanto a versão certa em produção?",
      "answer": "Defina a versão padrão do nvm e configure o gerenciador de processo para usá-la. Um cuidado comum é o systemd não enxergar o nvm, então aponte o caminho do Node correto no serviço."
    },
    {
      "question": "Posso ter versões diferentes para projetos diferentes?",
      "answer": "Pode. É exatamente para isso que o nvm serve. Cada projeto pode declarar a versão que precisa e você alterna conforme trabalha em cada um, sem reinstalar nada."
    }
  ],
  "howToSteps": [
    {
      "name": "Instalar o nvm",
      "text": "Instale o nvm no usuário que vai rodar as aplicações, sem precisar de root, e recarregue o terminal."
    },
    {
      "name": "Instalar uma versão do Node",
      "text": "Use o nvm para instalar a versão do Node que o projeto pede, podendo ter várias instaladas ao mesmo tempo."
    },
    {
      "name": "Definir a versão padrão",
      "text": "Marque uma versão como padrão para novas sessões e alterne quando um projeto exigir outra."
    },
    {
      "name": "Apontar o gerenciador de processo",
      "text": "Garanta que o PM2 ou o systemd use a versão correta do Node ao iniciar a aplicação no boot."
    }
  ],
  "relatedProducts": [
    "https://streethosting.com.br/vps",
    "https://streethosting.com.br/vps/ryzen",
    "https://streethosting.com.br/bots"
  ],
  "relatedGuides": [
    "https://streethosting.com.br/guias/vps/hospedar-api-nodejs-vps-brasil",
    "https://streethosting.com.br/guias/vps/configurar-pm2-startup-systemd-vps",
    "https://streethosting.com.br/guias/bots-discord/deploy-bot-discord-nodejs-pm2"
  ],
  "content": {
    "format": "markdown",
    "body": "> **Resposta rápida**\n>\n> O **nvm** instala e alterna entre versões do Node na VPS sem root e sem conflito. Instale o nvm no usuário das aplicações, instale a versão que o projeto pede, defina uma padrão e garanta que o PM2 ou o systemd use o caminho do Node correto no boot. Assim, projetos com versões diferentes convivem na mesma máquina.\n\n## Por que usar o nvm\n\nUm bot pede uma versão do Node, uma API pede outra. Instalar o Node direto pelo sistema prende você a uma só e torna a troca dolorosa. O nvm resolve mantendo várias versões lado a lado, prontas para alternar. É o complemento natural de quem roda [APIs Node na VPS](https://streethosting.com.br/guias/vps/hospedar-api-nodejs-vps-brasil).\n\n## Instalar o nvm\n\nInstale o nvm no usuário que vai rodar as aplicações, não no root. Após instalar, recarregue o terminal para o comando ficar disponível. A partir daí, todo o gerenciamento de versões acontece sem privilégio de administrador.\n\n## Instalar versões\n\n1. Instale a versão do Node que o projeto pede.\n2. Instale outras versões conforme a necessidade.\n3. Liste as versões instaladas para conferir.\n4. Alterne entre elas com um comando.\n\n> **Dica**\n>\n> Declare a versão do Node no projeto. Assim, qualquer pessoa que clonar o código sabe exatamente qual versão usar, sem adivinhação.\n\n## Versão em produção\n\n> **Atenção**\n>\n> O systemd costuma não enxergar o nvm por padrão. Aponte o caminho completo do Node correto no serviço, ou a aplicação pode subir com a versão errada no boot.\n\nConfigure o gerenciador de processo para a versão certa seguindo [PM2 ou systemd](https://streethosting.com.br/guias/vps/configurar-pm2-startup-systemd-vps).\n\n## Boas práticas\n\n- [ ] nvm instalado no usuário, sem root\n- [ ] Versão do Node declarada por projeto\n- [ ] Versão padrão definida para o boot\n- [ ] Gerenciador de processo apontando o Node correto\n\nCom o nvm, sua VPS roda quantos projetos Node precisar sem conflito de versão. Para deploy de bots, veja [deploy com PM2](https://streethosting.com.br/guias/bots-discord/deploy-bot-discord-nodejs-pm2) e conheça as [VPS Ryzen](https://streethosting.com.br/vps/ryzen)."
  }
}