1
0
mirror of https://github.com/containers/podman.git synced 2026-02-05 06:45:31 +01:00
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

1.0 KiB

% 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) Apply an OCI image to a Podman Machine's OS
upgrade podman-machine-os-upgrade(1) Upgrade a Podman Machine's OS

SEE ALSO

podman(1), podman-machine(1), podman-machine-os-apply(1), podman-machine-os-upgrade(1)

HISTORY

February 2023, Originally compiled by Ashley Cui acui@redhat.com