Projetos & Deploy

Auto-deploy via webhook

Cada projeto recebe uma URL de webhook própria, com um segredo único. Configure-a no GitHub e todo push na branch certa dispara um deploy sozinho.

Configurando no GitHub

Copie a URL do webhook

Na aba de configurações do projeto, copie a URL e o segredo gerados para ele.

Acesse o repositório no GitHub

Vá em Settings → Webhooks → Add webhook.

Cole a URL e o segredo

Defina o content type como application/json e cole o segredo copiado do painel.

Selecione o evento "push"

O webhook deve disparar apenas em eventos de push.

Ative o auto-deploy no projeto

Na aba de configurações, ligue o toggle correspondente.

Pronto

Com tudo configurado, o fluxo vira: você roda git push origin main → o GitHub notifica o painel → um novo deploy começa sozinho.

Segurança do webhook

Cada projeto tem seu próprio segredo, gerado automaticamente — não existe um segredo global compartilhado entre projetos. Toda notificação recebida é validada com esse segredo antes de disparar qualquer deploy; requisições sem assinatura válida são rejeitadas.

Testando localmente

O GitHub precisa alcançar uma URL pública para entregar o webhook. Se o seu painel estiver rodando apenas localmente, use um serviço de túnel para expor temporariamente a porta local e use a URL gerada como Payload URL no GitHub.