Como configurar um ambiente Node.js no VPS com PM2 para manter a aplicação sempre ativa
Olá, querido(a) desenvolvedor(a)!
Se você está aqui, provavelmente já tem uma aplicação Node.js pronta e quer deixá-la rodando 24h por dia, sem precisar ficar ligando o computador ou reabrindo o servidor toda hora. Que bom que você está no lugar certo! Aqui na GeHost, mesmo com planos de hospedagem tradicionais (cPanel), podemos te ajudar a montar um ambiente robusto para rodar seu projeto Node.js com PM2 — o superherói do gerenciamento de processos no Node.
Antes de começar: este guia é para clientes que já têm acesso ao servidor via SSH. Se você não tem acesso SSH, entre em contato com nosso suporte — ele pode te ajudar a habilitar esse recurso no seu plano.
Sensei diz: “O caminho do desenvolvedor começa com a paciência de entender o que está acontecendo por trás da tela. Vamos juntos?”
Passo 1: Acesse seu servidor via SSH
Para começar, você precisará de um cliente SSH. No Windows, recomendo o Windows Terminal ou Putty. No Mac e Linux, o terminal já vem pronto.
Conecte-se ao seu servidor usando o seguinte comando:
ssh usuario@seu-servidor.com.br
Substitua usuario pelo seu nome de usuário (geralmente o mesmo da conta cPanel) e seu-servidor.com.br pelo domínio ou IP do seu servidor (consulte seu painel ou suporte).
Passo 2: Instale o Node.js e o PM2
Seu servidor já vem com algumas ferramentas, mas vamos instalar o Node.js e o PM2 para garantir que tudo funcione perfeitamente.
Execute os comandos abaixo no terminal:
- Atualize o sistema:
sudo apt update && sudo apt upgrade -y
- Instale o Node.js (versão LTS):
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs
- Instale o PM2 globalmente:
sudo npm install -g pm2
Pronto! Agora você tem o Node.js e o PM2 instalados no seu servidor.
Passo 3: Prepare sua aplicação Node.js
Coloque seu projeto na pasta /home/usuario/public_html ou em uma pasta personalizada (como /home/usuario/app). Use o Gerenciador de Arquivos do cPanel para fazer isso, ou envie via FTP/SFTP.
Verifique se o arquivo principal da sua aplicação é index.js ou server.js. Se não for, ajuste o comando de inicialização mais tarde.
Passo 4: Inicie sua aplicação com o PM2
Abra o terminal no servidor e navegue até a pasta da sua aplicação:
cd /home/usuario/app
Depois, inicie sua aplicação com o PM2:
pm2 start index.js --name "minha-aplicacao"
Substitua index.js pelo nome do seu arquivo principal e minha-aplicacao pelo nome que você quer dar à sua aplicação no PM2 (pode ser qualquer nome).
Se tudo estiver certo, o PM2 vai iniciar seu servidor e mostrar uma lista com o status da aplicação.
Passo 5: Garanta que a aplicação inicie automaticamente após reinicialização
Um dos grandes truques do PM2 é que ele pode reiniciar sua aplicação automaticamente, mesmo após um reboot do servidor.
Execute este comando para salvar a configuração:
pm2 startup
Ele vai pedir permissão para criar um script de inicialização. Confirme com Y.
Depois, salve a lista de processos:
pm2 save
Pronto! Agora, toda vez que o servidor reiniciar, seu Node.js voltará a rodar sozinho.
Passo 6: Monitore e gerencie sua aplicação
Com o PM2, você pode monitorar tudo com comandos simples:
- Ver status:
pm2 status - Ver logs:
pm2 logs - Parar aplicação:
pm2 stop minha-aplicacao - Reiniciar:
pm2 restart minha-aplicacao - Excluir:
pm2 delete minha-aplicacao
Se quiser ver todos os processos em tempo real, use:
pm2 monit
Conclusão: Sua aplicação está sempre viva
Parabéns! Você acabou de transformar seu servidor em um ambiente de produção estável para sua aplicação Node.js. Com o PM2, ela agora roda 24h por dia, reinicia automaticamente após falhas e se mantém ativa mesmo após reinicializações.
Se precisar de ajuda com configurações avançadas, como SSL, domínios ou balanceamento, nossa equipe está aqui. Basta acessar o painel do cliente e abrir um chamado.
Sensei diz: “O verdadeiro poder não está no código, mas na persistência. Você já está no caminho certo. Continue assim!”
Se este guia te ajudou, compartilhe com quem também está aprendendo. E lembre-se: GeHost está com você, desde o primeiro console.log até o primeiro deploy em produção.
Com carinho,
Sensei da GeHost
Grupo: G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)
Sua hospedagem, seu futuro. 🌐