Deploy
Deploy, status, logs, rollback, and engine commands
axhub deploy
Deploy apps and manage deployments.
| Flag | Type | Description | Default |
|---|---|---|---|
--explain | boolean | Explain the local deploy spec from axhub.yaml without contacting the server | — |
axhub deploy cancel
Cancel an in-progress deploy.
| Flag | Type | Description | Default |
|---|---|---|---|
--app | string | — | — |
--deployment_id | string | — | — |
--dry-run | boolean | Preview only. Cancel is honored by the backend at deployment stage boundaries, so an in-flight build can take several minutes to flip to cancelled after --execute | true |
--execute | boolean | — | — |
axhub deploy codes
Explain deploy status and error codes.
(no options)
axhub deploy create
Start a new deploy.
| Flag | Type | Description | Default |
|---|---|---|---|
--app | string | — | — |
--commit | string | — | — |
--dry-run | boolean | — | true |
--execute | boolean | — | — |
--force-rebuild | boolean | — | — |
--no-retry | boolean | Disable timeout auto-retry for this mutation | — |
axhub deploy doctor
Diagnose an app's deploy setup.
| Flag | Type | Description | Default |
|---|---|---|---|
--app | string | — | — |
axhub deploy explain
Explain how a deploy is resolved.
| Flag | Type | Description | Default |
|---|---|---|---|
--app | string | — | — |
axhub deploy fleet
Deploy multiple apps at once.
| Flag | Type | Description | Default |
|---|---|---|---|
--apps | string | Comma-separated app slug/id list | — |
--commit | string | Commit SHA to deploy for every app | — |
--concurrency | integer | Maximum apps deployed in parallel | 10 |
--dry-run | boolean | Dry-run preview is the default | true |
--execute | boolean | Execute all deployment mutations | — |
--tenant | string | Tenant slug/id for diagnostics and future backend quota preflight | — |
axhub deploy git
Manage auto-deploy (GitHub) settings.
axhub deploy git configure
Configure auto-deploy.
| Flag | Type | Description | Default |
|---|---|---|---|
--app | string | — | — |
--branch | string | — | — |
--dry-run | boolean | — | true |
--execute | boolean | — | — |
--installation-id | integer | — | — |
--repo | string | — | — |
--state | string | — | — |
--update | boolean | — | — |
axhub deploy git connect
Connect a repo for auto-deploy.
| Flag | Type | Description | Default |
|---|---|---|---|
--app | string | — | — |
axhub deploy git disconnect
Disconnect auto-deploy.
| Flag | Type | Description | Default |
|---|---|---|---|
--app | string | — | — |
--dry-run | boolean | — | true |
--execute | boolean | — | — |
axhub deploy git status
Show auto-deploy status.
| Flag | Type | Description | Default |
|---|---|---|---|
--app | string | — | — |
axhub deploy list
List deployments.
| Flag | Type | Description | Default |
|---|---|---|---|
--all | boolean | — | — |
--app | string | — | — |
--ndjson | boolean | — | — |
--page | integer | — | — |
--page-size | integer | — | — |
--per-page | integer | — | — |
axhub deploy logs
View build and runtime logs.
| Flag | Type | Description | Default |
|---|---|---|---|
--app | string | — | — |
--deployment_id | string | Legacy deployment id. Runtime logs are now scoped to the app-level backend logs route | — |
--follow | boolean | — | — |
--limit | integer | Page size (1-1000, default 100) | — |
--reconnect-attempts | integer | Poll additional cursor pages this many times in follow mode | 0 |
--since | string | Show logs since this time (RFC3339) | — |
--source | string | Accepted for compatibility; app logs are not server-side filtered | — |
--until | string | Show logs until this time (RFC3339) | — |
axhub deploy rollback
Roll back to a previous deploy.
| Flag | Type | Description | Default |
|---|---|---|---|
--app | string | — | — |
--dry-run | boolean | — | true |
--execute | boolean | — | — |
--from-deployment | string | — | — |
axhub deploy status
Check deploy status.
| Flag | Type | Description | Default |
|---|---|---|---|
--app | string | — | — |
--deployment_id | string | — | — |
--watch | boolean | — | — |
--watch-interval | string | Poll interval such as 2s, 10s, 1m. Requires a unit suffix (s, m, h) | — |
--watch-timeout | string | Maximum watch duration such as 30m, 1h. Requires a unit suffix (s, m, h) | — |
axhub deploy watch
Watch a deploy until it finishes.
| Flag | Type | Description | Default |
|---|---|---|---|
--app | string | App id or slug | — |
--deployment_id | string | Deployment id to watch | — |
--no-tui | boolean | Force flat output. TUI support is reserved for a future visual pass | — |
--reconnect-attempts | integer | Retained for compatibility (no-op for watch streaming). Unlike deploy logs, this does NOT keep the stream alive under a non-interactive/agent context — use --watch-interval/--watch-timeout for an explicit bounded stream. Polling otherwise continues until terminal status or timeout | 3 |
--source | string | Log label: build, pod, events, pod-events, or all. Backend app logs are not source-filtered | all |
--watch-interval | string | Status poll interval such as 2s, 10s, 1m. Currently used for validation/future TUI polling | — |
--watch-timeout | string | Maximum watch duration. Defaults to 30m | — |
axhub status
Check an app's current deploy status.
(no options)
axhub engines
View available build/runtime engines.
axhub engines list
List engines.
(no options)