Como usar o Auto Restart na Square Cloud

O que é o Auto Restart

O Auto Restart reinicia sua aplicação automaticamente quando ela encerra com erro, com proteções contra loop de reinício, mantendo-a disponível sem ação manual. Ele vem desligado (AUTORESTART=false) por padrão.

Como ativar

No seu arquivo de configuração (squarecloud⁠.app ou squarecloud.config), adicione:

AUTORESTART=true

Como funciona

Quando o AUTORESTART está ativo e sua aplicação cai, a Square Cloud faz uma série de verificações antes de reiniciá-la:

1. A aplicação encerrou com erro (código de saída 1). Uma aplicação travada que não encerra, ou que foi parada por falta de memória, não é reiniciada automaticamente.
2. O uptime da aplicação foi maior que 60 segundos.
3. O exit status da aplicação foi 1.
4. A aplicação não reiniciou nos últimos 60 minutos.
5. Os logs não mostram um erro que um reinício não resolve: token de bot inválido, módulo ausente, erro de sintaxe ou de tipo do TypeScript, ou instalação de dependências que falhou. Nesses casos o Auto Restart não reinicia a aplicação, porque reiniciar não resolveria o problema.

Se todas as condições forem atendidas, a aplicação é reiniciada automaticamente. Há um cooldown de 60 minutos entre reinícios automáticos.

Boas práticas

• Revise seus logs com frequência para entender por que a aplicação está caindo — o Auto Restart a mantém online, mas não corrige a causa raiz.
• Mantenha seu arquivo MAIN e a alocação de memória corretos e atualizados.

Relacionados

Para mais formas de maximizar a disponibilidade, veja Como manter bots online 24/7. Se a aplicação fica caindo logo no boot, os logs geralmente indicam a causa — veja Minha aplicação não inicia: Verificando o script de start.

Atualizado em: 04/10/2026