App a partir do Git

Conectar a conta Git

Em Configurações → Contas Git, conecte o GitHub, GitLab, Gitea ou Bitbucket com um token de acesso. Repositórios públicos não precisam de conta. Para repositórios no formato git@…, cadastre uma chave em Configurações → Chaves SSH.

Criar o serviço

1. No projeto, clique em Novo serviço → App e escolha Git.
2. Escolha o repositório e o ramo (ex.: main).
3. Escolha como construir:
   • Dockerfile — o repositório já tem um Dockerfile;
   • Railpack — o painel descobre sozinho a linguagem e monta a imagem (Node, Python, Go, PHP, Ruby, Java…);
   • Site estático — HTML pronto ou gerado por um comando (ex.: npm run build).
4. Informe a porta em que o app escuta, se ele não for um site estático.
5. Clique em Criar e implantar.

O log da construção aparece ao vivo. Quando terminar, ligue um domínio.

Deploy automático

Na aba Avançado do serviço, ative o deploy automático. O painel mostra o endereço do webhook para colar no repositório (GitHub: Settings → Webhooks). A cada push no ramo escolhido, uma implantação nova começa sozinha.

Caminhos vigiados (monorepo)

Em repositórios com vários apps, informe os caminhos vigiados do serviço: um push que não mexe neles não dispara implantação.

Previews de pull request

Ative os previews e cada pull request ganha uma versão de teste com endereço próprio (pr-12.<domínio base>). Commit novo no PR reimplanta; PR fechado apaga o preview. Veja Previews.