wils@web ~ $ cat ~/ajuda/como-configurar-o-pm2-para-reiniciar-automaticamente-aplicacoes-node-js-em-caso-de-falhas.md

Desenvolvimento

Como configurar o PM2 para reiniciar automaticamente aplicações Node.js em caso de falhas

atualizado em 22/07/2026

O PM2 é um gerenciador de processos para aplicações Node.js que facilita a execução e monitoramento de aplicações em produção. Neste manual, vamos aprender como configurar o PM2 para reiniciar automaticamente suas aplicações em caso de falhas.

Pré-requisitos

  • Node.js instalado
  • PM2 instalado globalmente

Instalação do PM2

Se você ainda não tem 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 PM2, utilize o seguinte comando:

pm2 start nome_do_seu_arquivo.js

Substitua nome_do_seu_arquivo.js pelo nome do seu arquivo JavaScript.

Configuração de reinício automático

O PM2 reinicia automaticamente a aplicação se ela falhar. Para garantir que isso aconteça, você pode usar a opção --watch:

pm2 start nome_do_seu_arquivo.js --watch

Isso fará com que o PM2 monitore alterações no arquivo e reinicie a aplicação automaticamente.

Verificando o status da aplicação

Para verificar o status da sua aplicação, utilize:

pm2 status

Esse comando mostrará uma lista de todas as aplicações gerenciadas pelo PM2 e seu estado atual.

Configurações adicionais

Você pode configurar o PM2 para reiniciar a aplicação após um determinado número de falhas. Para isso, use:

pm2 start nome_do_seu_arquivo.js --max-restarts 5

Isso reiniciará a aplicação até 5 vezes em caso de falhas consecutivas.

Conclusão

O PM2 é uma ferramenta poderosa para gerenciar aplicações Node.js, garantindo alta disponibilidade e facilidade de monitoramento. Lembre-se de configurar os logs para acompanhar o desempenho e as falhas da sua aplicação.

Dica: Considere usar pm2 save para salvar a configuração atual e pm2 resurrect para restaurá-la após reinicializações do servidor.

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.