Como instalar Node.js e npm no VPS imprimir

Bem-vindo(a), vamos instalar o Node.js juntos! 🌱

Oi! Aqui é a Sensei da GeHost. Se você chegou até este guia, provavelmente quer rodar uma aplicação em Node.js (aquele projeto em React, uma API, um bot, etc.) na sua VPS. Respira fundo: não é nada complicado, e eu vou te guiar passo a passo, com calma, como se estivéssemos sentados lado a lado.

O Node.js é o "motor" que permite rodar JavaScript fora do navegador, direto no servidor. E o npm (Node Package Manager) é o gerenciador de pacotes que vem junto com ele — é por meio dele que você instala as bibliotecas que seu projeto precisa.

💡 Dica da Sensei: este guia assume que você já tem acesso via SSH à sua VPS (usuário e senha, ou chave, fornecidos no momento da contratação). Se você não sabe como acessar sua VPS, dá uma olhada no painel do cliente (painel.gehost.com.br) ou fale com o nosso suporte antes de continuar.

Antes de começar

• Um programa de terminal (no Windows: PowerShell ou algo como PuTTY; no Mac/Linux: o Terminal já resolve).
• Os dados de acesso SSH da sua VPS (usuário, senha ou chave).
• Um pouquinho de paciência — copiar e colar os comandos com calma já resolve 90% do caminho. 😉

Passo a passo

Passo 1 — Conecte-se à sua VPS via SSH

No seu terminal, digite (trocando pelos dados que você recebeu):

ssh usuario@seu-ip-ou-host

Digite a senha quando solicitado (ou use sua chave, se for esse o método configurado) e pronto, você está "dentro" do servidor.

Passo 2 — Atualize os pacotes do sistema

Antes de instalar qualquer coisa nova, é sempre uma boa prática atualizar a lista de pacotes do sistema operacional. Em distribuições baseadas em Debian/Ubuntu (as mais comuns):

sudo apt update && sudo apt upgrade -y

Se a sua VPS usa outra distribuição (CentOS, AlmaLinux etc.), o comando equivalente costuma ser:

sudo dnf update -y

Passo 3 — Instale o Node.js e o npm

Existem algumas formas de instalar, mas a mais recomendada hoje em dia é usar o NodeSource (um repositório oficial mantido pela comunidade Node.js), que garante uma versão atualizada e estável. Exemplo para instalar a versão LTS (a mais recomendada, "Long Term Support") em Debian/Ubuntu:

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

💡 Dica da Sensei: sempre prefira a versão LTS em vez da versão "current" (mais nova). A LTS é mais estável e recebe suporte por mais tempo — ideal para projetos em produção.

Outra opção bastante popular, especialmente se você pretende alternar entre várias versões do Node.js no futuro, é usar o nvm (Node Version Manager):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install --lts

Passo 4 — Confirme que deu tudo certo

Depois da instalação, verifique as versões instaladas:

node -v
npm -v

Se aparecerem os números das versões (por exemplo, algo como v20.x.x e 10.x.x), parabéns — está tudo funcionando! 🎉

Passo 5 — Teste criando um projeto simples

Para ter certeza de que o npm está funcionando de verdade, crie uma pasta de teste e inicialize um projeto:

mkdir meu-teste-node && cd meu-teste-node
npm init -y

Isso vai gerar um arquivo package.json. Se ele foi criado sem erros, seu ambiente Node.js + npm está pronto para receber sua aplicação de verdade.

Problemas comuns

• "Comando não encontrado" após instalar: feche e abra o terminal novamente (ou rode source ~/.bashrc) para recarregar o ambiente.
• Erro de permissão ao instalar pacotes globais com npm: evite usar sudo npm install -g sempre que possível; prefira o nvm, que instala tudo na sua pasta de usuário, sem precisar de permissões elevadas.
• Sua distribuição Linux não é Debian/Ubuntu/CentOS: consulte a documentação oficial do Node.js para o comando específico da sua distribuição.

Precisa de ajuda?

Se algum passo não funcionar como esperado, não se preocupe — isso é mais normal do que parece! Entre em contato com o nosso suporte ou consulte seu painel (painel.gehost.com.br) para verificar os detalhes e a documentação específica da sua VPS.

🌱 Dica final da Sensei: instalar o Node.js é só o primeiro passo. Depois disso, vale a pena aprender sobre gerenciadores de processo como o PM2, que mantêm sua aplicação rodando mesmo depois que você fecha o terminal — mas isso é assunto para um próximo guia!