Updates
Check for, apply and choose the channel of Lume updates.
Check for, apply and choose the channel of Lume updates.
| Command | Description |
|---|---|
lume check-update | Check whether a newer Lume release is available. |
lume update | Check for a Lume update and optionally apply it. |
lume channel | Inspect or change the stable/nightly update channel; selection does not install. |
lume channel status | Show selected and current release channels. |
lume channel set | Save stable or nightly as the update channel. |
Every command also accepts the global options.
lume check-update#Check whether a newer Lume release is available.
Read-only update check. Uses GitHub Releases, caches the result briefly, and never installs anything.
lume check-update [OPTIONS]| Flag | Type | Default | Description |
|---|---|---|---|
--json | boolean | false | Emit the structured update-state payload as JSON. |
--no-cache | boolean | false | Bypass the local update-check cache. |
Examples
lume check-update
lume check-update --json --no-cachelume update#Check for a Lume update and optionally apply it.
Without --apply, this command only checks for a newer release and prints the command to install it. With --apply, it runs the official Lume installer pinned to the discovered version and exits with the installer's status.
lume update [OPTIONS]| Flag | Type | Default | Description |
|---|---|---|---|
--apply | boolean | false | Apply the update by re-running the official installer. |
--json | boolean | false | Emit the structured update-state payload as JSON. |
Examples
lume update
lume update --applylume channel#Inspect or change the stable/nightly update channel; selection does not install.
The selection persists but never installs by itself; run lume update --apply after changing it. Without a subcommand, prints the status.
lume channel <COMMAND>lume channel status#Show selected and current release channels.
lume channel status [OPTIONS]| Flag | Type | Default | Description |
|---|---|---|---|
--json | boolean | false | Emit machine-readable channel state as JSON. |
Examples
lume channel status --jsonlume channel set#Save stable or nightly as the update channel.
lume channel set [OPTIONS] <channel>| Argument | Type | Default | Description |
|---|---|---|---|
<channel> | string | required | Release channel: stable or nightly. |
| Flag | Type | Default | Description |
|---|---|---|---|
--json | boolean | false | Emit machine-readable channel state as JSON. |
Examples
lume channel set nightly
lume channel set stable| Code | Meaning |
|---|---|
0 | Success. |
1 | The command failed (for example the VM does not exist or the operation errored). |
64 | Usage error: an unknown command or option, a missing argument, or an invalid value. |