Como configurar Node.js num VPS da GeHost para rodar uma aplicação imprimir

Bem-vindo(a) à aula de hoje: colocando seu Node.js pra rodar no VPS 🥋

Oi! Aqui é a Sensei da GeHost, e hoje eu vou te guiar, passo a passo, para colocar sua aplicação em Node.js rodando no seu VPS. Não se preocupe se você nunca mexeu com terminal antes — vamos com calma, um passo de cada vez, do jeitinho que ensino todo mundo por aqui. Bora lá?

O que você vai precisar antes de começar

• Um VPS ativo com você;
• Acesso via SSH (os dados de conexão ficam no seu painel do cliente, em painel.gehost.com.br — se não souber onde achar, é só chamar o suporte);
• Um programa pra acessar o terminal (no Windows, o PowerShell ou o PuTTY resolvem; no Mac/Linux, o próprio Terminal já serve);
• Sua aplicação Node.js pronta (ou pelo menos o código-fonte dela) para enviar ao servidor.

💡 Dica da Sensei: se você não tem certeza se seu VPS já vem com o acesso SSH liberado, ou não sabe o usuário/senha de conexão, fale com o nosso suporte pelo painel antes de continuar — eles te passam tudo certinho.

Passo 1 — Conectando no seu VPS via SSH

Abra o terminal do seu computador e conecte usando o comando abaixo (troque pelos dados que você recebeu no painel):

1. Digite ssh seu_usuario@seu_servidor e aperte Enter;
2. Confirme a conexão quando for perguntado (digite "yes");
3. Informe a senha quando solicitado (ela não aparece na tela enquanto você digita — é normal, é assim mesmo).

Se aparecer uma mensagem de boas-vindas do servidor, parabéns: você está conectado(a)! 🎉

Passo 2 — Atualizando o servidor

Antes de instalar qualquer coisa nova, é uma boa prática deixar o sistema atualizadinho. Rode:

1. sudo apt update
2. sudo apt upgrade -y

Isso pode levar alguns minutinhos — aproveita e toma um cafézinho enquanto espera. ☕

Passo 3 — Instalando o Node.js

Aqui na Sensei, eu sempre recomendo instalar o Node.js usando o NVM (Node Version Manager). É uma ferramenta que te deixa trocar de versão do Node facilmente, sem dor de cabeça no futuro.

1. Instale o NVM:
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
2. Feche e reabra o terminal (ou rode source ~/.bashrc) para o comando nvm ficar disponível;
3. Instale a versão do Node que você precisa, por exemplo:
   nvm install --lts
4. Confirme que deu certo:
   node -v e npm -v

Se apareceram os números das versões, seu Node.js já está instalado! 🙌

Passo 4 — Enviando sua aplicação pro servidor

Agora é hora de colocar o código da sua aplicação lá dentro. Você pode fazer isso de duas formas:

• Via Git: se seu projeto está num repositório, use git clone dentro do servidor;
• Via SFTP/upload: use um programa como o FileZilla para enviar os arquivos da sua aplicação para uma pasta no servidor.

Depois de enviar, entre na pasta do projeto (cd nome-da-pasta) e instale as dependências:

1. npm install

Passo 5 — Testando a aplicação

Chegou a hora da verdade! Rode sua aplicação com:

1. node nome-do-arquivo.js (ou o comando que sua aplicação usa, tipo npm start)

Se tudo estiver certo, sua aplicação já vai estar rodando. Mas repara: assim que você fechar o terminal, ela vai parar também — isso a gente resolve no próximo passo.

Passo 6 — Deixando a aplicação rodando sempre (PM2)

Pra sua aplicação continuar de pé mesmo depois que você sair do terminal (ou se o servidor reiniciar), o mais indicado é usar o PM2, um gerenciador de processos feito especialmente para Node.js.

1. Instale o PM2 globalmente:
   npm install -g pm2
2. Inicie sua aplicação com ele:
   pm2 start nome-do-arquivo.js --name "minha-app"
3. Confirme que está rodando:
   pm2 status
4. Configure para iniciar automaticamente caso o servidor reinicie:
   pm2 startup e depois pm2 save

💡 Dica da Sensei: com o PM2 você também consegue ver os logs da sua aplicação em tempo real com pm2 logs minha-app. Ótimo pra descobrir se algo deu errado.

Passo 7 — Deixando acessível pelo seu domínio

Por padrão, sua aplicação Node.js roda numa porta específica (ex.: 3000), e não diretamente pelo endereço do seu site. O caminho mais comum é usar um proxy reverso (como o Nginx) para direcionar as visitas do seu domínio até a porta da sua aplicação, e também configurar o apontamento do domínio para o seu servidor.

Essa parte tem alguns detalhes técnicos que variam de caso a caso (tipo de aplicação, se precisa de certificado SSL, etc.). Por isso, se você não tiver familiaridade com Nginx ou configuração de domínio, chama a nossa equipe pelo painel — a gente te ajuda a deixar tudo certinho com segurança.

Pronto! E agora?

Se sua aplicação está rodando com o PM2 e respondendo direitinho, você já deu um baita passo! 👏 Lembre-se: todo serviço contratado com a GeHost tem 30 dias de suporte gratuito após a entrega — então, se precisar de uma mãozinha nessa configuração, é só chamar a gente pelo painel.gehost.com.br.

🥋 Palavra final da Sensei: configurar um servidor pela primeira vez pode parecer assustador, mas vai com calma, um comando de cada vez. E se travar em algum passo, não sofre sozinho(a) — nosso suporte está aqui pra isso!