Connect a GitHub repository

3 min readUpdated August 2026

Git deploys start on the phase canvas. Use + Service → Git repository, then Connect Stackblaze to GitHub. That installs the GitHub App and lists repos you can deploy.

There is no npm CLI and no git.stackblaze.cloud remote. After the first deploy, Autodeploy on the app rebuilds when you push the connected branch.

The flow at a glance

Step by step

01

Open a project phase

In the dashboard, open a project and a phase (environment). On the canvas, click + Service and choose Git repository.

02

Connect GitHub

Click Connect Stackblaze to GitHub (or Link GitHub). Finish the GitHub App install for the org or user that owns the repo.

03

Pick the repo and branch

Select the repository and branch. StackBlaze scans the tree (Nixpacks, Dockerfile, Procfile web:/worker:, monorepo folders) and can seed more than one app card.

04

Review Build method, then commit

On the app, open Settings → Build. Confirm Build method (Nixpacks, Buildpacks, or Docker), Build path, and Port. Commit the staged change on the canvas to create the app.

05

Watch the deploy, then open the app

Follow the rollout on the Deployment tab and the build logs as they stream. When the deploy is live, open the public URL — every web app gets https://<app>.stackblaze.app.

What detection actually does

Detection fills the create form. You can change Build method and Build path before you commit. A Procfile web: or worker: line sets the app type and start command. It does not invent npm run build for every Node repo.