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

Desenvolvimento

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

atualizado em 18/08/2026

O PM2 é um gerenciador de processos para aplicações Node.js que permite que você mantenha suas aplicações em execução e reinicie-as automaticamente em caso de falhas. Neste manual, vamos aprender como configurar o PM2 para garantir que sua aplicação Node.js esteja sempre disponível.

Pré-requisitos

  • Node.js e npm instalados.
  • Acesso ao terminal do seu servidor Linux.

Instalação do PM2

Para instalar o PM2 globalmente, execute o seguinte comando:

npm install -g pm2

Iniciando sua aplicação com PM2

Para iniciar sua aplicação Node.js, utilize o comando abaixo, substituindo app.js pelo nome do seu arquivo:

pm2 start app.js

Configuração de reinício automático

O PM2 reinicia automaticamente a aplicação em caso de falha por padrão. No entanto, você pode configurar opções adicionais de reinício:

pm2 start app.js --watch

O parâmetro --watch faz com que o PM2 monitore alterações nos arquivos da aplicação e reinicie automaticamente quando uma mudança for detectada.

Gerenciamento de processos

Para visualizar o status das suas aplicações gerenciadas pelo PM2, use:

pm2 list

Para parar uma aplicação, utilize:

pm2 stop 

Substitua <id> pelo ID da aplicação exibido no comando anterior.

Persistência de processos

Para garantir que o PM2 inicie suas aplicações automaticamente após uma reinicialização do sistema, você pode usar o seguinte comando:

pm2 startup

Depois de executar esse comando, siga as instruções exibidas no terminal para completar a configuração.

Salvando a configuração atual

Salve a configuração atual do PM2 com:

pm2 save

Conclusão

Com o PM2 configurado, sua aplicação Node.js estará sempre em execução e será reiniciada automaticamente em caso de falhas. Uma dica útil é monitorar os logs da aplicação com:

pm2 logs

Dessa forma, você pode identificar rapidamente problemas que possam ocorrer.

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.