Como configurar um ambiente Node.js persistente com PM2 no VPS da GeHost
Olá, querido(a) desenvolvedor(a)!
Se você está aqui, provavelmente já tem um projeto em Node.js rodando no seu computador e quer deixá-lo sempre disponível na internet — mesmo depois de fechar o terminal ou reiniciar o servidor. Isso é possível com o PM2, um gerenciador de processos poderoso que mantém seu app rodando em segundo plano, mesmo quando você não está conectado.
Na GeHost, mesmo com planos de hospedagem compartilhada, é possível rodar aplicações Node.js com PM2 — desde que você tenha acesso ao terminal SSH (via cPanel) e o ambiente esteja configurado para isso. Vamos juntos, passo a passo, montar esse ambiente com carinho e segurança. Você não está sozinho nessa jornada — sou sua Sensei da GeHost! 🌿
Passo 1: Acesse o cPanel da GeHost
Para começar, faça login no painel do cliente:
- Visite painel.gehost.com.br
- Insira seu usuário e senha (os mesmos da sua conta de hospedagem)
- Após logar, clique em cPanel no menu principal.
Passo 2: Acesse o terminal via SSH (Shell Access)
Para instalar e configurar o PM2, precisamos de acesso ao terminal do servidor. No cPanel, isso é feito pelo Shell Access:
- No cPanel, procure pela ferramenta chamada Shell Access (geralmente na seção "Avançado").
- Clique em Shell Access para abrir o terminal.
- Se pedir, digite seu usuário de hospedagem e a senha novamente.
Pronto! Agora você está dentro do servidor. Você verá um prompt como:
user@servidor:~$
Passo 3: Instale o PM2 globalmente
O PM2 é uma ferramenta Node.js que gerencia processos. Vamos instalá-lo com o gerenciador de pacotes do Node.js (npm):
- No terminal, digite:
npm install -g pm2
Pressione Enter. O sistema vai baixar e instalar o PM2 em todo o servidor, tornando-o disponível para todos os seus projetos.
Dica da Sensei: Se aparecer um erro de permissão, tente usar o comando com sudo (ex: sudo npm install -g pm2), mas só se o seu plano permitir acesso elevado. Consulte seu plano no painel ou fale com o suporte.
Passo 4: Configure seu projeto Node.js
Antes de rodar o app com PM2, você precisa ter seu projeto em um diretório dentro de public_html ou em uma pasta personalizada (como node-app).
- Use o comando
cd public_htmloucd node-app(dependendo da pasta onde está seu projeto). - Verifique se tem um arquivo chamado
package.json(ele define o ponto de entrada do app). - Se não tiver, crie um com
npm init(siga as perguntas). - Instale as dependências do seu projeto com:
npm install
Isso garante que todas as bibliotecas do seu app estejam disponíveis.
Passo 5: Inicie seu app com PM2
Agora, vamos rodar seu app com o PM2. Você pode usar o nome do arquivo principal (ex: app.js ou server.js):
- No terminal, digite:
pm2 start app.js
Substitua app.js pelo nome do seu arquivo principal.
Se tudo der certo, você verá uma mensagem como:
PM2 successfully started
Parabéns! Seu app está rodando!
Passo 6: Torne o app persistente (não morre ao reiniciar)
O melhor de tudo: o PM2 salva a configuração. Assim, mesmo que o servidor reinicie, seu app volta a funcionar automaticamente.
- Digite no terminal:
pm2 startup
O sistema vai pedir permissão para criar um script de inicialização. Aceite com Y ou yes.
- Depois, salve a configuração atual:
pm2 save
Pronto! Agora seu app será iniciado automaticamente toda vez que o servidor reiniciar.
Passo 7: Monitore seu app com o painel do PM2
Para ver o status do seu app, use:
pm2 list
Isso mostra todos os processos rodando. Você verá seu app com status "online".
Para ver logs em tempo real (útil para depurar):
pm2 logs
Para parar o app:
pm2 stop app.js
Para reiniciar:
pm2 restart app.js
Passo 8: Acesse seu app na internet
Se seu app for uma API ou site, ele deve estar rodando na porta 3000 (ou outra que você definiu). Para acessá-lo:
- Use o endereço:
http://seu-dominio.com:3000 - Se não funcionar, verifique se o firewall ou configuração do servidor está liberando a porta.
Dica da Sensei: Se precisar de um domínio ou subdomínio para o seu app, crie um no cPanel em Domínios > Subdomínios e aponte para a pasta do seu projeto.
Conclusão: Você está no controle!
Com PM2, seu app Node.js está agora rodando 24 horas por dia, mesmo quando você não está conectado. É como ter um guardião invisível cuidando do seu projeto — com segurança, persistência e simplicidade.
Se surgir alguma dúvida, não hesite em entrar em contato com o suporte da GeHost. Nós estamos aqui para ajudar, com um sorriso e um coração de código aberto. 💙
Seu projeto está em boa mão. E você, está em boa companhia. 🌟
GeHost — hospedagem que entende de tecnologia e de pessoas. Grupo: G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)