NAME

       podman-machine-init - Initialize a new virtual machine

SYNOPSIS

       podman machine init [options] [name]

DESCRIPTION

       Initialize a new virtual machine for Podman.

       Podman  on  macOS  requires  a  virtual  machine.  This  is because containers are Linux -
       containers do not run on any other OS because containers' core functionality are  tied  to
       the Linux kernel.

       podman machine init initializes a new Linux virtual machine where containers are run.  SSH
       keys are automatically generated to access the VM, and  system  connections  to  the  root
       account and a user account inside the VM are added.

       By  default,  the VM distribution is Fedora CoreOS.  Fedora CoreOS upgrades come out every
       14 days and are detected and installed automatically. The VM will be rebooted  during  the
       upgrade.   For more information on updates and advanced configuration, please see the FCOS
       update docs here and here.

OPTIONS

   --cpus=number
       Number of CPUs.

   --disk-size=number
       Size of the disk for the guest VM in GB.

   --ignition-path
       Fully qualified path of the ignition file.

       If an ignition file is provided, the file will be copied  into  the  user's  CONF_DIR  and
       renamed.   Additionally,  no  SSH  keys  will be generated nor will a system connection be
       made.  It is assumed that the user will do these things manually or handle otherwise.

   --image-path
       Fully qualified path or URL to the VM image.  Can also be set to testing, next, or  stable
       to pull down default image.  Defaults to testing.

   --memory, -m=number
       Memory (in MB).

   --help
       Print usage statement.

EXAMPLES

              $ podman machine init
              $ podman machine init myvm
              $ podman machine init --disk-size 50
              $ podman machine init --memory=1024 myvm

SEE ALSO

       podman-machine(1)

HISTORY

       March 2021, Originally compiled by Ashley Cui acui@redhat.com ⟨mailto:acui@redhat.com⟩

                                                                         podman-machine-init(1)()