> ## 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 from GitHub

> Deploy an app from a connected GitHub repository.

Use GitHub deployments when your source code already lives in a repository.

## Goal

Create an app from a repository and optionally enable auto deploys.

## When to use

Use this flow for production apps, team workflows, and branch-based deploys.

## Example

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

## How it works

Hyze Cloud pulls the selected branch, installs dependencies, and starts the app.\
`startupCommand` is optional — omit it or set `"auto"` so Hyze detects the right command (Vite, Next, Node, static, Python…). Pass a custom command only when you need to override detection.

<Tip>
  Enable `autoDeploy` when pushes to the branch should trigger new deployments.
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="View logs" icon="terminal" href="/en/guides/view-logs">
    Inspect startup and runtime output.
  </Card>

  <Card title="Apps API" icon="book-open" href="/api-reference/apps">
    See all app endpoints.
  </Card>
</CardGroup>