canasta version
From Canasta Wiki
canasta > version
canasta version
Display version information
Synopsis
Always prints the Canasta CLI version and the target Canasta version (the image tag this CLI release is built to deploy).
Additional output depends on context:
- Inside an instance directory: also reports that instance's
pinned CANASTA_IMAGE tag and running runtime version.
- Outside any instance directory: lists every registered
instance with its pinned CANASTA_IMAGE tag (no runtime query; fast).
- With --id: reports full image + running version for the
named instance (same as inside that instance's directory).
- With --cli-only: prints only the CLI header; skips all
instance reads. Intended for scripts that just want the CLI version deterministically.
canasta version [flags]
Examples
canasta version
canasta version -i mysite
canasta version --cli-only
Flags
| Flag | Shorthand | Description | Default | Required | Orchestrator |
|---|---|---|---|---|---|
--cli-only |
-c |
Print only the CLI version; skip instance queries | Both | ||
--host |
-H |
Filter list-all output by host (default: all hosts) | Both | ||
--id |
-i |
Report image version for this instance | * | Both |
* Defaults to the Canasta instance matching the current directory, if any.
Global Flags
| Flag | Shorthand | Description | Default | Required | Orchestrator |
|---|---|---|---|---|---|
--help |
-h |
Show help message and exit | Both | ||
--verbose |
-v |
Enable verbose output | Both |