> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyzecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Deploy pelo GitHub

> Faça deploy de um app a partir de um repositório GitHub conectado.

Use deploys por GitHub quando seu código-fonte já estiver em um repositório.

## Objetivo

Criar um app a partir de um repositório e opcionalmente ativar auto deploys.

## Quando usar

Use este fluxo para apps de produção, workflows em equipe e deploys por branch.

## Exemplo

```bash theme={"system"}
curl -X POST https://api.hyzecloud.com/api/apps/deploy-from-repo \
  -H "Authorization: Bearer hyze_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "api",
    "runtime": "node",
    "memoryMB": 512,
    "exposePort": 3000,
    "autoDeploy": true,
    "repository": {
      "owner": "hyzecloud",
      "name": "api",
      "branch": "main"
    }
  }'
```

## Como funciona

A Hyze Cloud baixa a branch selecionada, instala dependências e inicia o app.\
`startupCommand` é opcional — omita ou use `"auto"` para a Hyze detectar o comando certo (Vite, Next, Node, estático, Python…). Passe um comando custom só quando precisar sobrescrever a detecção.

<Tip>
  Ative `autoDeploy` para que pushes na branch disparem novos deploys automaticamente.
</Tip>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Ver logs" icon="terminal" href="/pt/guides/view-logs">
    Inspecione a saída de inicialização e runtime.
  </Card>

  <Card title="API de Apps" icon="book-open" href="/api-reference/apps">
    Veja todos os endpoints de apps.
  </Card>
</CardGroup>