spiegel_podman/docs/source/markdown
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
..
links Revert "Rewrite the Quadlet documentation." 2025-09-11 19:00:19 +02:00
options Merge pull request #26445 from aaron-ang/update-ulimit 2026-01-16 08:38:00 -05:00
.gitignore docs: Update filter options and add podman ps documentation 2025-12-06 10:47:13 +00:00
podman-artifact-add.1.md.in Allow artifact add to override org.opencontainers.image.title annotation 2025-10-16 14:24:57 -04:00
podman-artifact-extract.1.md [CI:DOCS] Remove Experimental from Artifacts man pages 2025-07-31 18:39:25 -04:00
podman-artifact-inspect.1.md Fixes: #27444, Fix tiny typos in some artifact docs 2025-11-06 05:30:42 +00:00
podman-artifact-ls.1.md.in Add CreatedAt format option to podman artifact ls 2025-10-23 09:35:21 -04:00
podman-artifact-pull.1.md.in [CI:DOCS] Remove Experimental from Artifacts man pages 2025-07-31 18:39:25 -04:00
podman-artifact-push.1.md.in Fixes: #27444, Fix tiny typos in some artifact docs 2025-11-06 05:30:42 +00:00
podman-artifact-rm.1.md cmd/podman: --ignore errors flag to artifact rm 2025-10-01 18:22:26 -03:00
podman-artifact.1.md Add --replace option to podman artifact add command 2025-10-06 12:22:40 -04:00
podman-attach.1.md.in Add information about --latest support on man pages 2024-01-23 07:28:40 -05:00
podman-auto-update.1.md.in Revert "Rewrite the Quadlet documentation." 2025-09-11 19:00:19 +02:00
podman-build.1.md.in Revert "Deduplicate more options." 2025-09-11 19:00:02 +02:00
podman-commit.1.md Create a podman-troubleshooting man page 2024-08-28 05:49:45 -06:00
podman-completion.1.md Remove unnecessary backslashes 2023-08-02 15:01:16 +01:00
podman-compose.1.md.in Fix typo 2025-08-07 07:28:06 +02:00
podman-container-checkpoint.1.md Fix documentation around checkpoints 2025-07-06 17:16:29 +02:00
podman-container-cleanup.1.md Remove future tense from man pages 2023-05-16 15:10:33 -04:00
podman-container-clone.1.md.in Fix up example description of podman-container commands 2024-02-19 15:18:51 -05:00
podman-container-diff.1.md.in fix 26348: add container diff --latest doc 2025-06-13 11:28:11 +02:00
podman-container-exists.1.md Remove future tense from man pages 2023-05-16 15:10:33 -04:00
podman-container-inspect.1.md.in Bunch of trivial manpage fixes 2025-06-12 02:22:42 -04:00
podman-container-prune.1.md Fix up example description of podman-container commands 2024-02-19 15:18:51 -05:00
podman-container-restore.1.md Add support for criu's tcp-close functionality. 2025-08-27 18:52:34 -04:00
podman-container-runlabel.1.md.in Manpages: podman container runlabel added example with --replace 2025-08-05 18:04:37 +05:30
podman-container.1.md man pages and command help: clean up descriptions 2023-05-28 18:57:43 +02:00
podman-cp.1.md docs: Improve spelling and formatting 2025-03-24 16:35:29 -06:00
podman-create.1.md.in docs: Add references to quadlet 2025-11-08 08:56:06 +01:00
podman-diff.1.md.in Bunch of trivial manpage fixes 2025-06-12 02:22:42 -04:00
podman-events.1.md Fixes #27378 Missing network type in events document 2025-10-28 04:17:42 +00:00
podman-exec.1.md.in feat(exec): Add --no-session flag for improved performance 2025-11-19 12:44:48 -05:00
podman-export.1.md Fix up example description of podman-export/export commands 2024-02-18 12:26:33 -05:00
podman-farm-build.1.md.in Add missing manpages options for Buildah v1.41.0 2025-07-23 10:36:22 -04:00
podman-farm-create.1.md Bunch of trivial manpage fixes 2025-06-12 02:22:42 -04:00
podman-farm-list.1.md Fixes: #26353 2025-08-15 23:14:24 +05:30
podman-farm-remove.1.md Fix up example description of podman-farm commands 2024-02-18 08:02:29 -05:00
podman-farm-update.1.md Fix up example description of podman-farm commands 2024-02-18 08:02:29 -05:00
podman-farm.1.md document new connection/farm storage location 2024-02-08 18:05:32 +01:00
podman-generate-spec.1.md docs: add three examples to podman-generate-spec man page 2025-06-19 20:17:08 +09:00
podman-generate-systemd.1.md Revert "Rewrite the Quadlet documentation." 2025-09-11 19:00:19 +02:00
podman-generate.1.md Deprecate podman generate systemd 2023-08-03 06:58:53 -04:00
podman-healthcheck-run.1.md Fix up example description of podman-healthcheck-run.1.md 2024-02-17 13:54:15 -05:00
podman-healthcheck.1.md Fix manpage headers 2022-09-06 09:37:13 -07:00
podman-history.1.md Apply suggestions from code review 2024-02-20 05:38:19 -05:00
podman-image-diff.1.md Bunch of trivial manpage fixes 2025-06-12 02:22:42 -04:00
podman-image-exists.1.md Fix up example description of podman-image commands 2024-02-18 07:41:47 -05:00
podman-image-inspect.1.md Fix up example description of podman-image commands 2024-02-18 07:41:47 -05:00
podman-image-mount.1.md Bunch of trivial manpage fixes 2025-06-12 02:22:42 -04:00
podman-image-prune.1.md docs: Improve spelling and formatting 2025-03-24 16:35:29 -06:00
podman-image-scp.1.md Fix up example description of podman-image commands 2024-02-18 07:41:47 -05:00
podman-image-sign.1.md.in Correct markdown in docs 2023-05-18 16:44:24 -07:00
podman-image-tree.1.md Fix up example description of podman-image commands 2024-02-18 07:41:47 -05:00
podman-image-trust.1.md.in Fix up example description of podman-image commands 2024-02-18 07:41:47 -05:00
podman-image-unmount.1.md add more exmples applying current style for each page 2025-06-16 19:52:36 +02:00
podman-image.1.md man pages and command help: clean up descriptions 2023-05-28 18:57:43 +02:00
podman-images.1.md.in docs: Deduplicate --filter descriptions 2025-12-05 00:36:53 +00:00
podman-import.1.md Improve the file format documentation of podman-import. 2025-03-31 18:00:23 +02:00
podman-info.1.md Fix up example description of podman-info.1.md 2024-02-17 13:54:19 -05:00
podman-init.1.md.in Add examples of --all flag 2025-06-13 04:47:22 -04:00
podman-inspect.1.md.in Add artifact fallback to podman inspect command 2025-10-02 06:52:32 -04:00
podman-kill.1.md.in Fix up example description of podman-kill.1.md.in 2024-02-19 10:06:05 -05:00
podman-kube-apply.1.md Try to fix the broken formatting of man podman‐kube‐apply(1). 2023-11-06 14:53:35 +01:00
podman-kube-down.1.md feat(cmd): podman kube play support multiple arguments 2025-10-22 12:10:46 +02:00
podman-kube-generate.1.md Add support for Job to kube generate & play 2024-09-05 11:36:38 -04:00
podman-kube-play.1.md.in fix remote command parameters 2025-10-18 02:08:51 +03:00
podman-kube.1.md [CI:DOCS] Update kube docs 2024-04-04 09:28:21 -04:00
podman-load.1.md Bunch of trivial manpage fixes 2025-06-12 02:22:42 -04:00
podman-login.1.md.in man pages: refactor two more options 2024-09-03 11:13:46 -06:00
podman-logout.1.md.in man pages: refactor two more options 2024-09-03 11:13:46 -06:00
podman-logs.1.md.in Fix language, typos and markdown layout 2023-07-24 11:18:25 +02:00
podman-machine-cp.1.md Introduce podman machine cp command 2025-02-28 09:56:46 -05:00
podman-machine-info.1.md Add disclaimer to podman machine info manpage. 2024-09-03 15:23:18 -04:00
podman-machine-init.1.md.in Add update-connection to machine start and init 2025-11-04 10:35:28 -06:00
podman-machine-inspect.1.md Fixes: #26353 2025-08-15 23:14:24 +05:30
podman-machine-list.1.md.in Provider obfuscation in command line 2025-10-27 08:40:19 -05:00
podman-machine-os-apply.1.md use bootc for os apply 2026-01-08 13:32:39 -06:00
podman-machine-os-upgrade.1.md Add podman machine os upgrade command 2026-01-16 14:14:06 -06:00
podman-machine-os.1.md Add podman machine os upgrade command 2026-01-16 14:14:06 -06:00
podman-machine-reset.1.md add more exmples applying current style for each page 2025-06-16 19:52:36 +02:00
podman-machine-rm.1.md Add information about --latest support on man pages 2024-01-23 07:28:40 -05:00
podman-machine-set.1.md.in Mention containers.conf settings for podman machine commands 2024-10-14 08:17:47 -04:00
podman-machine-ssh.1.md Add information about --latest support on man pages 2024-01-23 07:28:40 -05:00
podman-machine-start.1.md.in Add update-connection to machine start and init 2025-11-04 10:35:28 -06:00
podman-machine-stop.1.md Add information about --latest support on man pages 2024-01-23 07:28:40 -05:00
podman-machine.1.md Machine init --provider 2025-10-29 07:59:34 -05:00
podman-manifest-add.1.md.in Bunch of trivial manpage fixes 2025-06-12 02:22:42 -04:00
podman-manifest-annotate.1.md.in Bunch of trivial manpage fixes 2025-06-12 02:22:42 -04:00
podman-manifest-create.1.md.in Add man page content for artifacts 2024-02-29 11:47:44 -05:00
podman-manifest-exists.1.md Fix up example description of podman-manifest commands 2024-02-17 13:54:04 -05:00
podman-manifest-inspect.1.md.in Bunch of trivial manpage fixes 2025-06-12 02:22:42 -04:00
podman-manifest-push.1.md.in Add --sign-by-sq-fingerprint to push operations 2025-09-11 20:32:32 +02:00
podman-manifest-remove.1.md podman-manifest-remove: update docs and help output 2024-09-17 11:36:12 -04:00
podman-manifest-rm.1.md Bunch of trivial manpage fixes 2025-06-12 02:22:42 -04:00
podman-manifest.1.md podman-manifest-remove: update docs and help output 2024-09-17 11:36:12 -04:00
podman-mount.1.md.in Bunch of trivial manpage fixes 2025-06-12 02:22:42 -04:00
podman-network-connect.1.md Fixes: #26374 add example network connect with mac address 2025-06-14 16:45:41 +09:00
podman-network-create.1.md Revert "Deduplicate more options." 2025-09-11 19:00:02 +02:00
podman-network-disconnect.1.md Fix up example description of podman-network commands 2024-02-18 07:48:08 -05:00
podman-network-exists.1.md Fix up example description of podman-network commands 2024-02-18 07:48:08 -05:00
podman-network-inspect.1.md podman network inspect: include running containers 2024-02-28 16:33:26 +01:00
podman-network-ls.1.md.in docs: Deduplicate --filter descriptions 2025-12-05 00:36:53 +00:00
podman-network-prune.1.md Fix up example description of podman-network commands 2024-02-18 07:48:08 -05:00
podman-network-reload.1.md.in Remove iptables references in docs 2025-11-21 01:10:19 +01:00
podman-network-rm.1.md Removed the 'Deleted: ' prefix from each example 2025-06-17 19:00:44 +09:00
podman-network-update.1.md Fix up example description of podman-network commands 2024-02-18 07:48:08 -05:00
podman-network.1.md Fix slirp4netns typo in podman-network.1.md 2025-01-04 20:04:59 +02:00
podman-pause.1.md.in docs: Deduplicate --filter descriptions 2025-12-05 00:36:53 +00:00
podman-pod-clone.1.md.in docs: add resource limit examples to podman pod clone manpage 2025-07-28 20:28:17 +05:30
podman-pod-create.1.md.in docs: add examples with resource limits and mounts to podman pod create manpage 2025-08-01 23:10:05 +05:30
podman-pod-exists.1.md Fix up example description of podman-pod commands 2024-02-19 10:03:30 -05:00
podman-pod-inspect.1.md.in Fixes: #26353 2025-08-15 23:14:24 +05:30
podman-pod-kill.1.md.in Fix up example description of podman-pod commands 2024-02-19 10:03:30 -05:00
podman-pod-logs.1.md.in Fix up example description of podman-pod commands 2024-02-19 10:03:30 -05:00
podman-pod-pause.1.md Add examples of --all flag 2025-06-13 04:47:22 -04:00
podman-pod-prune.1.md add more exmples applying current style for each page 2025-06-16 19:52:36 +02:00
podman-pod-ps.1.md.in docs: Deduplicate --filter descriptions 2025-12-05 00:36:53 +00:00
podman-pod-restart.1.md fix podman-pod-restart.1.md typo 2024-04-18 19:53:33 -04:00
podman-pod-rm.1.md.in Fix up example description of podman-pod commands 2024-02-19 10:03:30 -05:00
podman-pod-start.1.md.in Fix up example description of podman-pod commands 2024-02-19 10:03:30 -05:00
podman-pod-stats.1.md.in Bunch of trivial manpage fixes 2025-06-12 02:22:42 -04:00
podman-pod-stop.1.md.in Add information about --latest support on man pages 2024-01-23 07:28:40 -05:00
podman-pod-top.1.md.in Add information about --latest support on man pages 2024-01-23 07:28:40 -05:00
podman-pod-unpause.1.md Fix up example description of podman-pod commands 2024-02-19 10:03:30 -05:00
podman-pod.1.md man pages and command help: clean up descriptions 2023-05-28 18:57:43 +02:00
podman-port.1.md.in Apply suggestions from code review 2024-02-20 05:46:41 -05:00
podman-ps.1.md.in docs: Update filter options and add podman ps documentation 2025-12-06 10:47:13 +00:00
podman-pull.1.md.in Revert "Deduplicate more options." 2025-09-11 19:00:02 +02:00
podman-push.1.md.in Add --sign-by-sq-fingerprint to push operations 2025-09-11 20:32:32 +02:00
podman-quadlet-install.1.md Merge pull request #27384 from flouthoc/multi-file-quadlet 2025-11-18 16:01:08 +00:00
podman-quadlet-list.1.md docs: Add references to quadlet 2025-11-08 08:56:06 +01:00
podman-quadlet-print.1.md docs: Add references to quadlet 2025-11-08 08:56:06 +01:00
podman-quadlet-rm.1.md docs: Add references to quadlet 2025-11-08 08:56:06 +01:00
podman-quadlet.1.md docs: Add references to quadlet 2025-11-08 08:56:06 +01:00
podman-remote.1.md Create a podman-troubleshooting man page 2024-08-28 05:49:45 -06:00
podman-rename.1.md Add information about --latest support on man pages 2024-01-23 07:28:40 -05:00
podman-restart.1.md.in docs: Deduplicate --filter descriptions 2025-12-05 00:36:53 +00:00
podman-rm.1.md.in docs: Update filter options and add podman ps documentation 2025-12-06 10:47:13 +00:00
podman-rmi.1.md Merge pull request #26388 from tyll/rmi-no-prune 2025-06-12 13:42:50 +00:00
podman-run.1.md.in fix: remove unnecessary -t flag from podman run commands in documentation 2025-12-17 22:29:40 +00:00
podman-save.1.md.in Bunch of trivial manpage fixes 2025-06-12 02:22:42 -04:00
podman-search.1.md.in docs: Deduplicate --filter descriptions 2025-12-05 00:36:53 +00:00
podman-secret-create.1.md Secret create - add ignore option to allow noop 2025-06-24 15:43:38 -04:00
podman-secret-exists.1.md Remove future tense from man pages 2023-05-16 15:10:33 -04:00
podman-secret-inspect.1.md Update docs/source/markdown/podman-secret-inspect.1.md 2025-06-12 15:52:31 +02:00
podman-secret-ls.1.md.in docs: Deduplicate --filter descriptions 2025-12-05 00:36:53 +00:00
podman-secret-rm.1.md docs: add an example to podman-secret-rm man page 2025-06-18 21:10:17 +09:00
podman-secret.1.md Add support for secret exists 2023-04-03 15:33:50 +03:00
podman-start.1.md.in docs: Deduplicate --filter descriptions 2025-12-05 00:36:53 +00:00
podman-stats.1.md.in docs: Remove Cgroups v1 2025-11-12 15:15:34 -05:00
podman-stop.1.md.in docs: Deduplicate --filter descriptions 2025-12-05 00:36:53 +00:00
podman-system-check.1.md Skip layer digests for podman system check --quick 2025-06-05 17:00:50 +00:00
podman-system-connection-add.1.md Implement TLS API Support 2025-09-26 09:09:54 -06:00
podman-system-connection-default.1.md Fix up example description of podman-system commands 2024-02-20 08:18:51 -05:00
podman-system-connection-list.1.md Implement TLS API Support 2025-09-26 09:09:54 -06:00
podman-system-connection-remove.1.md Add examples of --all flag 2025-06-13 04:47:22 -04:00
podman-system-connection-rename.1.md Fix up example description of podman-system commands 2024-02-20 08:18:51 -05:00
podman-system-connection.1.md Fix up example description of podman-system commands 2024-02-20 08:18:51 -05:00
podman-system-df.1.md Fixes: #26353 2025-08-15 23:14:24 +05:30
podman-system-migrate.1.md docs: add examples to podman-system-migrate man page 2025-06-15 01:48:21 -04:00
podman-system-prune.1.md Manpages: Added --filter flag examples to all the relevant podman 2025-08-05 18:12:14 +05:30
podman-system-renumber.1.md manpages: adds example for podman system renumber 2025-07-07 13:58:56 -04:00
podman-system-reset.1.md add more exmples applying current style for each page 2025-06-16 19:52:36 +02:00
podman-system-service.1.md Implement TLS API Support 2025-09-26 09:09:54 -06:00
podman-system.1.md Add podman system check for checking storage consistency 2024-06-04 10:00:37 -04:00
podman-systemd.unit.5.md Fix podman run equivalent for HealthStartPeriod 2026-01-14 15:48:52 -05:00
podman-tag.1.md Add information about --latest support on man pages 2024-01-23 07:28:40 -05:00
podman-top.1.md.in docs: add missing groups and hgroups descriptors to podman-top documentation 2025-08-15 19:46:56 +05:30
podman-unmount.1.md.in add more exmples applying current style for each page 2025-06-16 19:52:36 +02:00
podman-unpause.1.md.in docs: Deduplicate --filter descriptions 2025-12-05 00:36:53 +00:00
podman-unshare.1.md Fix up example description of podman-unshare.1.md 2024-02-17 13:54:29 -05:00
podman-untag.1.md Add information about --latest support on man pages 2024-01-23 07:28:40 -05:00
podman-update.1.md.in Add ulimits to podman update API 2025-11-20 22:59:50 -08:00
podman-version.1.md [CI:DOCS] man pages: document some --format options 2022-09-15 09:59:32 -06:00
podman-volume-create.1.md volumes: add new --uid and --gid option 2025-06-18 15:33:09 +02:00
podman-volume-exists.1.md Remove future tense from man pages 2023-05-16 15:10:33 -04:00
podman-volume-export.1.md Refactor volume import to support the remote client 2025-06-23 13:42:22 -04:00
podman-volume-import.1.md Refactor volume import to support the remote client 2025-06-23 13:42:22 -04:00
podman-volume-inspect.1.md Only stop chowning volumes once they're not empty 2024-05-22 17:47:01 -04:00
podman-volume-ls.1.md.in docs: Deduplicate --filter descriptions 2025-12-05 00:36:53 +00:00
podman-volume-mount.1.md Fix up example description of podman-volume commands 2024-02-19 10:09:06 -05:00
podman-volume-prune.1.md Add information about --latest support on man pages 2024-01-23 07:28:40 -05:00
podman-volume-reload.1.md Add information about --latest support on man pages 2024-01-23 07:28:40 -05:00
podman-volume-rm.1.md Add information about --latest support on man pages 2024-01-23 07:28:40 -05:00
podman-volume-unmount.1.md Fix up example description of podman-volume commands 2024-02-19 10:09:06 -05:00
podman-volume.1.md man pages and command help: clean up descriptions 2023-05-28 18:57:43 +02:00
podman-wait.1.md.in Fixes: #26691 2025-08-06 22:34:18 +03:00
podman.1.md Remove network-cmd-path 2025-12-19 16:52:49 -05:00
podmansh.1.md Revert "Rewrite the Quadlet documentation." 2025-09-11 19:00:19 +02:00