Hanzo

Deploy on Hanzo

Ship any Git repo to Hanzo in one click with hanzo.app/new, and add a "Deploy on Hanzo" badge to your README so anyone can launch your project.

Deploy on Hanzo

Turn any public Git repository into a running app on Hanzo in one click. hanzo.app clones the repo, provisions the project, and walks you through deploy -- no local setup, no CLI. OSS authors add a Deploy on Hanzo badge to their README so anyone can launch the project the same way.

One-Click Deploy

Send anyone to a pre-filled deploy flow by pointing template at a repository:

https://hanzo.app/new?template=OWNER/REPO

Opening the URL takes the visitor to hanzo.app, imports the repo into a new project, and steps them through configuration and deploy. The template value accepts a GitHub owner/repo shorthand or a full Git URL:

# GitHub shorthand
https://hanzo.app/new?template=hanzoai/example-app

# Any Git URL
https://hanzo.app/new?template=https://github.com/hanzoai/example-app

Deploys run on the same Hanzo PaaS that powers the platform, and usage draws down your cloud-credit balance like every other product.

Add the Badge to Your README

Give visitors a button that launches your project in one click. Add this snippet to your README, replacing OWNER/REPO with your repository:

[![Deploy on Hanzo](https://hanzo.app/button.svg)](https://hanzo.app/new?template=OWNER/REPO)

It renders as a clickable button that opens the one-click deploy flow for your repo. The load-bearing part is the link target -- hanzo.app/new?template=… -- which works whether or not the badge image is present.

The button image is served from hanzo.app; grab the current badge markdown straight from the site to stay on the canonical asset. The deploy link itself never changes.

  • Getting Started -- create an account and claim $5 in free credits
  • PaaS -- the Kubernetes-native platform your deploys run on
  • Credits & Billing -- how deploys and usage draw down credits
  • Startup Program -- up to $150,000 in credits for venture-backed teams
  • hanzo.app -- the browser IDE and deploy surface

How is this guide?

Last updated on

On this page