# Platform

URL: https://docs.hanzo.ai/docs/cli/platform

> The `hanzo build` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/platform) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/platform) · [SDKs](https://docs.hanzo.ai/docs/sdks)

Hanzo PaaS: deploy containers to your own tenant namespace — builds, releases, environments, logs, custom domains.

[API reference →](https://docs.hanzo.ai/docs/openapi/platform)

```bash
hanzo platform apps list
```

Every command takes `--json` for the raw response and `--help` for its own flags. Sign in once with `hanzo auth login`; the commands below use that session, and the org they act in is the one it carries.

| Command                       | What it does                                                         |
| ----------------------------- | -------------------------------------------------------------------- |
| `hanzo build create`          | Triggers a native build — an image, or the binaries a repo declares. |
| `hanzo platform builds`       | Returns real build records for your org.                             |
| `hanzo platform cd`           | Answers every Application the delivery plane holds.                  |
| `hanzo platform environments` | Returns your deploy targets, and what is running on each.            |
| `hanzo platform health`       | Reports whether this control plane can actually deploy anything.     |
| `hanzo platform pipelines`    | Returns one build-and-deploy pipeline per app, with its latest run.  |
| `hanzo platform releases`     | Returns the versions that actually reached the cluster.              |
| `hanzo platform run`          | Runs a container image and gives back a URL.                         |

### Apps

| Command                         | What it does                                                                                                                               |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `hanzo platform apps cd <app>`  | Answers ONE app's reconciliation alone — the poll a deploy console makes while it waits, without re-reading the whole inventory each time. |
| `hanzo platform apps create`    | Deploy an app through cd.hanzo.ai                                                                                                          |
| `hanzo platform apps get <app>` | Answers ONE declaration — what git says this app is, before the delivery plane has had any say in it.                                      |
| `hanzo platform apps list`      | Answers what this organisation has declared, joined with what the delivery plane has done about it.                                        |

### Fleet

| Command                          | What it does                                                       |
| -------------------------------- | ------------------------------------------------------------------ |
| `hanzo platform fleet get <app>` | Returns one platform service, resolved to production by default.   |
| `hanzo platform fleet list`      | Returns the platform's own service tier, and where it has drifted. |

### Projects

| Command                                                              | What it does                                                                           |
| -------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| `hanzo platform projects apps create <project>`                      | Creates an application from a git repo or a container image.                           |
| `hanzo platform projects apps deploy <project> <app>`                | Deploys the app — building it first if it comes from git.                              |
| `hanzo platform projects apps deployments get <project> <app> <id>`  | Returns one deployment of one app.                                                     |
| `hanzo platform projects apps deployments list <project> <app>`      | Returns an app's deployment history.                                                   |
| `hanzo platform projects apps deployments logs <project> <app> <id>` | Returns real logs for a deployment — the build's, then the app's.                      |
| `hanzo platform projects apps domains create <project> <app>`        | Attaches a hostname — instantly if you already own it, otherwise with a DNS challenge. |
| `hanzo platform projects apps domains list <project> <app>`          | Returns every hostname this app answers on.                                            |
| `hanzo platform projects apps domains rm <project> <app> <host>`     | Detaches a hostname and releases the claim.                                            |
| `hanzo platform projects apps domains verify <project> <app> <host>` | Checks a custom domain's DNS and turns it on if it passes.                             |
| `hanzo platform projects apps env <project> <app>`                   | Replaces an app's environment variables.                                               |
| `hanzo platform projects apps get <project> <app>`                   | Returns one application, with its live phase, health and secret sync.                  |
| `hanzo platform projects apps list <project>`                        | Returns the applications in one project, with what the cluster says about them.        |
| `hanzo platform projects apps preview <project> <app>`               | Puts a branch on its own URL.                                                          |
| `hanzo platform projects apps promote <project> <app>`               | Promotes an already-built release to the app.                                          |
| `hanzo platform projects apps rm <project> <app>`                    | Deletes an application and tears down what it runs.                                    |
| `hanzo platform projects apps rollback <project> <app>`              | Goes back to the previous release.                                                     |
| `hanzo platform projects apps start <project> <app>`                 | Starts a stopped app back up.                                                          |
| `hanzo platform projects apps stop <project> <app>`                  | Stops an app without deleting it.                                                      |
| `hanzo platform projects get <project>`                              | Answers one project and every app in it.                                               |
| `hanzo platform projects list`                                       | Answers every project the caller may see, with how its apps stand.                     |