CLI reference
kusaw update
Check the configured release source, show what would change, and install only after confirmation. Downloads are verified (signature and checksum) before the apply step.
kusaw update
Check the configured release source, show what would change, and install only after confirmation. Downloads are verified (signature and checksum) before the apply step.
Usage
kusaw update [flags]Flags
| Name | Short | Type | Default | Description |
|---|---|---|---|---|
--check | bool | false | Print what is available and exit | |
--config | string | Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search) | ||
--factory | string | factory name from kusaw list | ||
--help | -h | bool | false | help for update |
--json | bool | false | Print JSON | |
--plan | bool | false | Dry-run migrations and kusaw.yaml upgrades (used during update) | |
--pre | bool | false | Consider pre-release versions | |
--set-source | string | Set update.source to an https URL or folder, or off to clear it | ||
--show-key | bool | false | Print the built-in release public key fingerprint | |
--suspend-now | bool | false | Suspend running runs at the step boundary and continue the update | |
--to | string | Install this version (vX.Y.Z) when it is at the source | ||
--wait | duration | 30m0s | How long running steps may finish before the update asks or stops | |
--yes | bool | false | Confirm the install without a prompt |
Exit codes
| Code | Name | Description |
|---|---|---|
| 0 | ok | Success. |
| 1 | error | Runtime error. |
| 2 | usage | Usage or validation error. |
| 3 | rejected | Control request rejected; the error string is printed verbatim. |
| 4 | not picked up | Control request not picked up within the wait time while serve runs. |
Example
kusaw update --check