Files
podman/docs/source/markdown/podman-machine-os.1.md
Brent Baude aba2df7517 Add podman machine os upgrade command
Implements automatic OS upgrade functionality for Podman machines that requires no user input beyond running the command. The upgrade logic automatically determines the appropriate upgrade path using a three-way comparison between client version, machine version, and OCI registry:

* When the client version is older than the machine version, no action is taken and an error is returned.
* When the client version matches the machine version, the OCI registry is queried to check for in-band updates by comparing image digests.  This handles minor, patch level, and updates oci image use cases.
* When the client version is newer than the machine version, the machine is upgraded to match the client's major.minor version.
* No manual image selection or version specification required.

The command supports dry-run mode and JSON (only) output format for automation.

Signed-off-by: Brent Baude <bbaude@redhat.com>
2026-01-16 14:14:06 -06:00

24 lines
1.0 KiB
Markdown

% podman-machine-os 1
## NAME
podman\-machine\-os - Manage a Podman virtual machine's OS
## SYNOPSIS
**podman machine os** *subcommand*
## DESCRIPTION
`podman machine os` is a set of subcommands that manage a Podman virtual machine's operating system.
## SUBCOMMANDS
| Command | Man Page | Description |
|---------|--------------------------------------------------------------|---------------------------------------------|
| apply | [podman-machine-os-apply(1)](podman-machine-os-apply.1.md) | Apply an OCI image to a Podman Machine's OS |
| upgrade | [podman-machine-os-upgrade(1)](podman-machine-os-upgrade.1.md) | Upgrade a Podman Machine's OS |
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-machine(1)](podman-machine.1.md)**, **[podman-machine-os-apply(1)](podman-machine-os-apply.1.md)**, **[podman-machine-os-upgrade(1)](podman-machine-os-upgrade.1.md)**
## HISTORY
February 2023, Originally compiled by Ashley Cui <acui@redhat.com>