Articles on: Deploying Your Site

How to deploy a website from GitHub

Connect your GitHub account and deploy straight from a repository. Every push to your default branch (usually main) updates your site automatically. Available on every plan.


Uninstalling the Tiiny Host app in GitHub permanently deletes every site you deployed from GitHub, including ones on a custom domain. Removing one repository from the app deletes that repository's site. Email support@tiiny.host first if you only want to stop automatic updates.


Before you start


We publish your built files, not your source code. We look for HTML in these folders, in order: build, dist, out, www, static, _site, docs. If none has any, we check package.json for React, Vue, Angular or Next.js and use that framework's usual output folder. Otherwise we use your repository's main folder. Commit and push your built files.


Connect and deploy


  1. On your dashboard, open the Upload file dropdown and choose Deploy from GitHub. Once connected, it says View Repositories.

The Deploy from GitHub option in the Upload file dropdown

  1. Sign in to GitHub and choose which repositories we can see.
  2. Your repositories appear. Click Resync if a new one is missing.

The repository list with the Resync button

  1. Click the repository and choose a link name, or let us generate one.
  2. Click Deploy.

The Deploy button for a selected repository


To use a custom domain, choose it from the dropdown next to the link name. It must be validated first: see How to connect a domain you already own.


Limits


Your plan's project and file-size limits apply, plus a 75 MB maximum repository size. On the free plan you can update a project 3 times a day, and PHP needs a paid plan. You'll see an upgrade prompt before the deploy starts.


Updating your site


Push to your default branch and we pick it up. Pushes to other branches are ignored. If you rename the repository, click Resync.


Automatic updates don't show errors. If your site didn't change after a push, deploy again from your dashboard to see what's wrong.


Repository access is managed in GitHub: Settings → Applications → Tiiny Host → Configure.


Common errors


  • "GitHub integration not set up": Connect again from Deploy from GitHub.
  • "Invalid OAuth parameters", "User email not provided" or "Failed to store credentials": The connection didn't finish. Try again; if it repeats, email us the exact message.
  • "Unauthorized" when deploying: That link name or domain belongs to another account. Pick another link name.
  • "Oops! We couldn't deploy this repository" or "Failed to fetch the repository": Click Resync and deploy again. Still failing? Connect again from Deploy from GitHub.
  • "Failed to fetch repositories": Try again in a minute, or connect again.
  • "Invalid link-name": Use only letters, numbers and hyphens.
  • Deployed but blank: We didn't find your built files. Check the output folder (like dist) is pushed and has an index.html, then Resync and deploy again.

Updated on: 10/11/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!