wils@web ~ $ cat ~/ajuda/como-configurar-pm2-5-2-para-reiniciar-automaticamente-sua-aplicacao-node-js-em-caso-de-falhas.md

Desenvolvimento

Como configurar PM2 5.2 para reiniciar automaticamente sua aplicação Node.js em caso de falhas

atualizado em 01/08/2026

O PM2 é um gerenciador de processos para aplicações Node.js que permite que você mantenha suas aplicações em execução, reinicie-as automaticamente em caso de falhas e realize o gerenciamento de logs. Neste manual, vamos mostrar como configurar o PM2 5.2 para reiniciar automaticamente sua aplicação Node.js em caso de falhas.

Pré-requisitos

  • Node.js instalado
  • PM2 instalado globalmente

Instalando o PM2

Se você ainda não possui o PM2 instalado, execute o seguinte comando:

npm install -g pm2

Iniciando sua aplicação com PM2

Para iniciar sua aplicação Node.js com o PM2, utilize o comando abaixo:

pm2 start app.js --name minha-aplicacao

Substitua app.js pelo nome do seu arquivo principal.

Configurando reinício automático

Por padrão, o PM2 já reinicia a aplicação automaticamente em caso de falhas. No entanto, você pode configurar opções adicionais, como o número máximo de reinícios e o tempo de espera entre eles. Para isso, utilize:

pm2 start app.js --name minha-aplicacao --max-restarts 10 --restart-delay 5000

Isso configura o PM2 para tentar reiniciar a aplicação até 10 vezes, com um intervalo de 5 segundos entre as tentativas.

Monitorando sua aplicação

Você pode monitorar sua aplicação em tempo real com o comando:

pm2 monit

Salvando a configuração

Para garantir que suas aplicações sejam reiniciadas automaticamente após um reboot do servidor, salve a configuração do PM2:

pm2 save

Depois, configure o PM2 para iniciar na inicialização do sistema:

pm2 startup

Conclusão

Com o PM2 configurado, sua aplicação Node.js estará mais resiliente a falhas. Lembre-se de sempre verificar os logs para entender o motivo das falhas. Você pode visualizar os logs com:

pm2 logs minha-aplicacao

Dica: Considere utilizar o pm2 ecosystem para gerenciar aplicações mais complexas com múltiplos serviços.

Precisa de ajuda com isso no seu servidor? A gente resolve pra você.

falar no WhatsApp

// deu erro ou não funcionou?

Achou algo errado neste manual?

Conta pra gente o que deu errado ou qual erro apareceu — a gente corrige. Se quiser retorno, deixe seu contato.