github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/podman-machine-os-apply.1.md (about)

     1  % podman-machine-os-apply 1
     2  
     3  ## NAME
     4  podman\-machine\-os\-apply - Apply an OCI image to a Podman Machine's OS
     5  
     6  ## SYNOPSIS
     7  **podman machine os apply** [*options*] *image* [vm]
     8  
     9  ## DESCRIPTION
    10  
    11  Apply machine OS changes from an OCI image.
    12  
    13  VM's that use OS's that use rpm-ostreee have the capability to rebase itself from the content of an OCI image.
    14  `podman machine image apply` takes an OCI image with container native ostree functionality and rebases itself on that image.
    15  
    16  By default, Podman machines on Mac and Linux use an rpm-ostree based distribution (Fedora CoreOS).
    17  
    18  For more information, see the [rpm-ostree documentation](https://coreos.github.io/rpm-ostree/container/).
    19  
    20  The default machine name is `podman-machine-default`. If a machine name is not specified as an argument,
    21  then the OS changes will be applied to `podman-machine-default`.
    22  
    23  ## OPTIONS
    24  
    25  #### **--help**
    26  
    27  Print usage statement.
    28  
    29  #### **--restart**
    30  
    31  Restart VM after applying changes.
    32  
    33  ## EXAMPLES
    34  
    35  Update the default Podman machine to the specified bootable OCI image.
    36  ```
    37  $ podman machine os apply quay.io/podman_next
    38  ```
    39  
    40  Update the specified Podman machine to the specified bootable OCI image.
    41  ```
    42  $ podman machine os apply quay.io/podman_next podman-machine-default
    43  ```
    44  
    45  ## SEE ALSO
    46  **[podman(1)](podman.1.md)**, **[podman-machine(1)](podman-machine.1.md)**, **[podman-machine-os(1)](podman-machine-os.1.md)**
    47  
    48  ## HISTORY
    49  February 2023, Originally compiled by Ashley Cui <acui@redhat.com>