Skip to content

CLI Reference

CLI Reference

Type: Reference · Audience: CLI user

Global Options

Flag Default Description
--cluster, -c Tenant cluster name (scopes resource operations)
--output, -o table Output format: table, wide, yaml, json
--selector, -l Label selector (key=value)
--rezusconfig ~/.rezuscloud/config Path to config file

Commands

rezusctl boot

Bootstrap the management cluster. This is the only standalone command — all others require a running management plane.

rezusctl boot --platform <docker|qemu> [--name <name>]
Flag Default Description
--platform docker Target platform: docker or qemu
--name rezuscloud Cluster name
--control-planes 1 Number of control plane nodes
--workers 0 Number of worker nodes
--talos-version latest Talos version
--cilium-version 1.19.3 Cilium version
--state-dir .rezusctl State directory

Boot is idempotent — re-run skips completed steps. Drift detection re-provisions if needed.

Generic Resource Commands

rezusctl get <type> [<name>]

List or describe resources.

rezusctl get clusters                  # List all tenants
rezusctl get cluster prod              # Get single tenant
rezusctl get machines                  # List all machines
rezusctl get machines -c prod          # List machines in cluster prod
rezusctl get ng -c prod                # List node groups
rezusctl get providers                 # List providers

rezusctl create <type> [<name>]

Create a resource from stdin or flags.

rezusctl create cluster prod

rezusctl apply -f <file>

Create or update a resource from a YAML/JSON file.

rezusctl delete <type> <name>

Delete a resource.

rezusctl delete cluster prod
rezusctl delete machine <id> -c prod

rezusctl describe <type> <name>

Show detailed resource information.

Specialized Commands

rezusctl cluster

rezusctl cluster status <name>     # Formatted cluster status
rezusctl cluster delete <name>     # Delete cluster

rezusctl machine

rezusctl machine list              # Cluster-wide
rezusctl machine list -c prod      # Tenant-scoped
rezusctl machine get <id>          # Machine details

rezusctl logs <machine-id> -c <cluster>

Stream machine logs via SSE.

rezusctl logs hw-001 -c prod
rezusctl logs hw-001 -c prod -f    # Follow
rezusctl logs hw-001 -c prod --tail 50  # Last 50 lines

rezusctl kubeconfig <cluster>

Fetch kubeconfig for a tenant cluster.

rezusctl kubeconfig prod
rezusctl kubeconfig prod -o ~/kubeconfigs/prod.yaml

rezusctl talosconfig <cluster>

Fetch talosconfig for a tenant cluster.

rezusctl user

rezusctl user create <name> --role admin --password <pass>
rezusctl user list
rezusctl user delete <name>

rezusctl config

Manage CLI configuration.

rezusctl config url <url>          # Set management plane URL
rezusctl config token <token>      # Set auth token
rezusctl config context <name>     # Switch context
rezusctl config contexts           # List contexts
rezusctl config info               # Show current config

rezusctl api-resources

List all known resource types and their API paths.

rezusctl version

Print version information.

Resource Type Short Names

Short Full Scoped
cluster Cluster No
machines Machine No
ng NodeGroup Yes (requires -c)
patch ConfigPatch Yes (requires -c)
provider Provider No
user User No

Exit Codes

Code Meaning
0 Success
1 General error
2 Command misuse (invalid flags, missing arguments)

Configuration

File Location Purpose
~/.rezuscloud/config Home dir Contexts, URL, token (YAML)
.rezusctl/ Working dir Boot state (step markers, kubeconfig)