FreeBSD Manual Pages
podman-machine-os-apply(1) General Commands Manual podman-machine-os-apply(1) NAME podman-machine-os-apply - Apply an OCI image to a Podman Machine's OS SYNOPSIS podman machine os apply [options] image [vm] DESCRIPTION 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. podman machine image apply takes an OCI image with container native ostree functionality and re- bases itself on that image. 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 dif- ferences. Podman machine images are stored as OCI images at quay.io/podman/ma- chine-os. When applying an image using this command, the fully quali- fied 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 at- tempt to pull only the statement version as itself. For more information, see the rpm-ostree documentation. The default machine name is podman-machine-default. If a machine name is not specified as an argument, then the OS changes will be applied to podman-machine-default. OPTIONS --help Print usage statement. --restart Restart VM after applying changes. EXAMPLES 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 ma- chine 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/machine-os:5.4 Update the specified Podman machine to latest Podman 5.3 bootable OCI image. $ podman machine os apply quay.io/podman/machine-os:5.3 mymachine SEE ALSO podman(1), podman-machine(1), podman-machine-os(1) HISTORY February 2023, Originally compiled by Ashley Cui acui@redhat.com <mailto:acui@redhat.com> podman-machine-os-apply(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | HISTORY
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-machine-os-apply&sektion=1&manpath=FreeBSD+Ports+15.0>