containers
/
podman
mirror of https://github.com/containers/podman.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #25451 from baude/issue25435 

Update documentation for podman-machine-os-apply
This commit is contained in:
openshift-merge-bot[bot] 2025-03-04 20:04:32 +00:00 committed by GitHub
parent c37a47ae52 7f4282a7e8
commit 7f27a6661a
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 21 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
docs/source/markdown/podman-machine-os-apply.1.md
View File

@ -13,7 +13,16 @@ Apply machine OS changes from an OCI image.
VM's that use OS's that use rpm-ostreee have the capability to rebase itself from the content of an OCI image. VM's that use OS's that use rpm-ostreee have the capability to rebase itself from the content of an OCI image.
`podman machine image apply` takes an OCI image with container native ostree functionality and rebases itself on that image. `podman machine image apply` takes an OCI image with container native ostree functionality and rebases itself on that image.
By default, Podman machines on Mac and Linux use an rpm-ostree based distribution (Fedora CoreOS). By default, Podman machines on Mac, Linux, and Windows Hyper-V use a customized rpm-ostree based distribution (Fedora CoreOS). Machines based on Microsoft WSL use a
customized Fedora distribution and cannot be updated with this command.
Note: WSL-based machines are upgradable by using the `podman machine ssh <machine_name>` command followed by `sudo dnf update`. This can, however, result in unexpected results in
Podman client and server version differences.
Podman machine images are stored as OCI images at `quay.io/podman/machine-os`. When applying an image using this
command, the fully qualified OCI reference name must be used including tag where the tag is the
version of Podman that is inside the VM. By default, Podman will attempt to pull only the statement
version as itself.
For more information, see the [rpm-ostree documentation](https://coreos.github.io/rpm-ostree/container/). For more information, see the [rpm-ostree documentation](https://coreos.github.io/rpm-ostree/container/).
@ -32,14 +41,21 @@ Restart VM after applying changes.
## EXAMPLES ## EXAMPLES
Update the default Podman machine to the specified bootable OCI image. Update the default Podman machine to the latest development version of the
bootable OCI image.
Note: This may result in having a newer Podman version inside the machine
than the client. Unexpected results may occur.
Update the default Podman machine to the most recent Podman 5.4 bootable
OCI image.
``` ```
$ podman machine os apply quay.io/podman_next $ podman machine os apply quay.io/podman/machine-os:5.4
``` ```
Update the specified Podman machine to the specified bootable OCI image. Update the specified Podman machine to latest Podman 5.3 bootable OCI image.
``` ```
$ podman machine os apply quay.io/podman_next podman-machine-default $ podman machine os apply quay.io/podman/machine-os:5.3 mymachine
``` ```
## SEE ALSO ## SEE ALSO