.nh
.TH podman-machine-os-apply 1
.SH NAME
.PP
podman-machine-os-apply - Apply an OCI image to a Podman Machine's OS

.SH SYNOPSIS
.PP
\fBpodman machine os apply\fP [\fIoptions\fP] \fIimage\fP [vm]

.SH DESCRIPTION
.PP
Apply machine OS changes from an OCI image.

.PP
VM's that use OS's that use rpm-ostreee have the capability to rebase itself from the content of an OCI image.
\fBpodman machine image apply\fR takes an OCI image with container native ostree functionality and rebases itself on that image.

.PP
By default, Podman machines on Mac and Linux use an rpm-ostree based distribution (Fedora CoreOS).

.PP
For more information, see the rpm-ostree documentation.

.PP
The default machine name is \fBpodman-machine-default\fR\&. If a machine name is not specified as an argument,
then the OS changes will be applied to \fBpodman-machine-default\fR\&.

.SH OPTIONS
.SS \fB--help\fP
.PP
Print usage statement.

.SS \fB--restart\fP
.PP
Restart VM after applying changes.

.SH EXAMPLES
.PP
Update the default Podman machine to the specified bootable OCI image.

.EX
$ podman machine os apply quay.io/podman_next
.EE

.PP
Update the specified Podman machine to the specified bootable OCI image.

.EX
$ podman machine os apply quay.io/podman_next podman-machine-default
.EE

.SH SEE ALSO
.PP
\fBpodman(1)\fP, \fBpodman-machine(1)\fP, \fBpodman-machine-os(1)\fP

.SH HISTORY
.PP
February 2023, Originally compiled by Ashley Cui acui@redhat.com
\[la]mailto:acui@redhat.com\[ra]