Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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 it-
     self 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.

     By  default,  Podman machines on Mac, Linux, and Windows Hyper-V use a cus-
     tomized 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, re-
     sult 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 ref-
     erence name must be used including tag where the tag is the version of Pod-
     man 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.

     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 pod-
     man-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 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/machine-os:5.4

     Update  the  specified Podman machine to latest Podman 5.3 bootable OCI im-
     age.

     $ 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)

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.1.quarterly>

home | help