HostKB Cloud
Sign in

Docs/Deploy from GitHub

Deploy from GitHub

Connect GitHub, create a HostKB application from your repository, build the image, and deploy to production with HTTPS.

Connect GitFull getting started guide

1. Connect your GitHub account

HostKB needs access to list your repositories.

  1. Sign in to HostKB Cloud and open Integrations → Git.
  2. Connect GitHub (or another supported provider) and authorize the integration.
  3. Confirm your repositories appear when you create an application.

2. Create an application from the repository

Pick Git Repository as the source type.

  1. Open a project and click Add Application, or go to New application.
  2. Choose Git Repository, then select GitHub, the repository, and the branch you want to deploy.
  3. Optionally enable Auto-deploy on push so later pushes build and deploy for you (auto-deploy guide).
  4. Under Advanced Options, set a root directory only if the app lives in a subfolder of the repo.
  5. Choose an application size allowed by your plan, then create the application.

3. Build and deploy

Git apps need a successful build before they can go live.

  1. Open the app → Builds → Start Build. Watch live logs until the build succeeds.
  2. Open Deployments → Deploy. Follow logs until status is Running.
  3. Open the app URL. HTTPS may take a minute or two on the first deploy while the certificate is issued.

Add environment variables before or after the first deploy, then deploy again so the live app picks up new values.

Sample apps (optional)

Download a ZIP from HostKB (no GitHub access needed), push it to your own repo, then connect that repo here.

Unzip, push the files to a new GitHub repository (as the repo root), then create the app from that repo. Step-by-step: example apps guide.

What you get

Related guides

  • Getting started — Create projects and apps, set environment variables, then build and deploy from the UI.
  • What is HostKB Cloud? — HostKB Cloud is a free hosting and deployment platform — deploy apps from Git with HTTPS and logs.
  • Free app hosting — Free hosting for Node.js, Python, .NET, Java, React, Angular, Next.js, Vue, PHP, and Docker apps.
  • Free deployment platform — Free deployment platform to deploy apps from Git — builds, HTTPS, domains, and auto-deploy.
  • Sample apps (download) — Download Node.js, .NET, or Python sample ZIPs, push to your Git repo, and try a free deploy.
  • Custom domains & HTTPS — Attach your own domain, point DNS, and serve your app over automatic HTTPS.
  • Environment variables — Add app and project variables, mark secrets, and redeploy so the live app picks them up.
  • Auto-deploy on push — Enable auto-deploy so pushes to your selected branch build and deploy automatically.
  • Build & deploy logs — Watch real-time build and deployment logs to troubleshoot releases on HostKB Cloud.
  • App sizes & scaling — Choose the right application size for CPU and memory, then upgrade as your workload grows.