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

# GitHub Deploys

> Connect a repository and deploy your site automatically on every push

Connect a GitHub repository to a site and Sontairo Hosting deploys the repository's files as the site's file system — commit, push, and your site updates.

## Connect a repository

1. Open your site and go to the **GitHub** tab in Settings
2. Enter the **Repository URL**
3. Choose the **Branch** to deploy from (defaults to `main`)
4. Click **Import files from repo** to pull the repository into the site

The repository tree becomes the site's files: the same files you see in the repo are what gets served, with `index.html` as the entry point.

## Auto-deploy on push

Turn on the **Auto deploy** toggle in the GitHub tab. Once enabled, every push to the connected branch triggers a new production deployment. Each deployment appears in the site's deployments list on the Overview tab with its status and commit reference, and the [AI health check](/hosting/ai-monitor) runs after it goes live.

## Limits

GitHub deploys follow the same limits as every other deploy method:

* 200 files per site
* 8 MB total
* 2 MB per file

If your repository contains project source rather than a ready-to-serve site, deploy the built output instead — for example by committing your `dist/` folder to a deploy branch, or by using the [CLI](/hosting/cli) from your CI pipeline.

<Tip>
  GitHub deploys and [CLI deploys](/hosting/cli) work on the same site — use whichever fits your workflow, or both.
</Tip>