Como usar o Auto Restart na Square Cloud

O que é o Auto Restart

O Auto Restart é um recurso exclusivo da Square Cloud que reinicia sua aplicação automaticamente em caso de crash, ajudando a mantê-la disponível sem nenhuma ação manual.

Como ativar

No seu arquivo 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 caiu ou travou.
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 contêm um erro excluído — SyntaxError, versão inexistente, módulo não encontrado ou arquivo de dependências inválido. 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: 13/06/2026