Quickstart
Deploy your first application in five minutes.
This guide walks you through signing up, connecting a cluster, and deploying an application. Total time: about five minutes.
Prerequisites
- A hanzo.id account (sign up is free)
- One of: a Kubernetes cluster, Docker Swarm, or Docker Compose host
- A Git repository or Docker image to deploy
No cluster yet? The platform can provision one on DigitalOcean or Hetzner for you during setup.
Deploy in Five Minutes
Sign up and create an organization
Go to app.platform.hanzo.ai and sign in with your hanzo.id account. Create a new organization to hold your projects, clusters, and team members.
Connect a cluster
Navigate to Clusters and click Add Cluster. Choose your orchestrator:
Run the agent install command on any machine with kubectl access:
hanzo cluster add --name my-cluster --type kubernetesThe command outputs a kubectl apply manifest that installs the Hanzo agent
into the hanzo-system namespace. The agent connects outbound to the
platform -- no inbound firewall rules needed.
On a Swarm manager node:
hanzo cluster add --name my-cluster --type swarmThe agent runs as a Swarm service and reports node/service state to the platform.
On the target host:
hanzo cluster add --name my-cluster --type composeThe agent runs as a container alongside your Compose stacks.
Wait for the cluster status to show Connected in the dashboard.
Create a project
Click New Project. Give it a name and select the cluster you just connected.
A project groups related services, databases, and other resources under one roof. You can add multiple environments (dev, staging, production) later.
Deploy your application
Choose your deployment source:
- Click Add Service and select Git.
- Connect your GitHub, GitLab, or Bitbucket account.
- Pick the repository and branch.
- The platform auto-detects your
Dockerfile(or you can specify a Buildpack). Every push to the branch triggers a build and deploy.
git push origin main
# Platform builds and deploys automatically- Click Add Service and select Docker Image.
- Enter the image reference, e.g.
ghcr.io/yourorg/app:latest. - If the registry is private, add credentials under Settings > Registries.
- Click Deploy.
# Or deploy from the CLI
hanzo deploy --project my-project --image ghcr.io/yourorg/app:latestVerify the deployment
Open the service in the dashboard to see real-time logs and status. Once the health check passes, your app is live.
# Or check from the terminal
hanzo logs --project my-project --service app --followWhat's Next
- Key Concepts -- Deeper look at orgs, projects, environments, and clusters.
- CLI Reference -- Full list of CLI commands.
- Deployments -- Advanced deployment strategies, rollbacks, and scaling.
How is this guide?
Last updated on