NAME

       podman-machine-set - Set a virtual machine setting

SYNOPSIS

       podman machine set [options] [name]

DESCRIPTION

       Change a machine setting.

       The  default  machine  name is podman-machine-default. If a machine name is not specified as an argument,
       then the settings will be applied to podman-machine-default.

       Rootless only.

OPTIONS

   --cpus=number
       Number of CPUs.  Only supported for QEMU machines.

   --disk-size=number
       Size of the disk for the guest VM in GB.  Can only be increased. Only supported for QEMU machines.

   --help
       Print usage statement.

   --memory, -m=number
       Memory (in MB).  Only supported for QEMU machines.

   --rootful
       Whether this machine prefers rootful (true) or rootless (false) container execution. This option  updates
       the  current  podman  remote connection default if it is currently pointing at the specified machine name
       (or podman-machine-default if no name is specified).

       Unlike [podman system connection default] this option makes the API socket, if available, forward to  the
       rootful/rootless socket in the VM.

       Note  that  changing  this  option  means that all the existing containers/images/volumes, etc...  are no
       longer visible with the default connection/socket. This is because the root and rootless users in the  VM
       are  completely  separated  and do not share any storage. The data however is not lost and you can always
       change this option back or use the other connection to access it.

   --usb=bus=number,devnum=number or vendor=hexadecimal,product=hexadecimal or ""
       Assign a USB device from the host to the VM.  Only supported for QEMU Machines.

       The device needs to be present when the VM starts.  The device needs to have proper permissions in  order
       to be assign to podman machine.

       Use an empty string to remove all previously set USB devices.

       Note that using bus and device number are simpler but the values can change every boot or when the device
       is  unplugged.  Using vendor and product might lead to collision in the case of multiple devices with the
       same vendor product value, the first available device is assigned.

   --user-mode-networking
       Indicates that this machine relays traffic from the guest through a user-space  process  running  on  the
       host. In some VPN configurations the VPN may drop traffic from alternate network interfaces, including VM
       network  devices.  By  enabling user-mode networking (a setting of true), VPNs observe all podman machine
       traffic as coming from the host, bypassing the problem.

       When the qemu backend is used (Linux, Mac), user-mode networking is mandatory and the only allowed  value
       is  true.  In  contrast,  The Windows/WSL backend defaults to false, and follows the standard WSL network
       setup.  Changing this setting to true on Windows/WSL informs Podman to replace the WSL  networking  setup
       on  start  of  this  machine instance with a user-mode networking distribution. Since WSL shares the same
       kernel across distributions, all other running distributions reuses this  network.   Likewise,  when  the
       last machine instance with a true setting stops, the original networking setup is restored.

EXAMPLES

       To switch the default VM podman-machine-default from rootless to rootful:

       $ podman machine set --rootful

       or more explicitly:

       $ podman machine set --rootful=true

       To switch the default VM podman-machine-default from rootful to rootless:

       $ podman machine set --rootful=false

       To switch the VM myvm from rootless to rootful:

       $ podman machine set --rootful myvm

SEE ALSO

       podman(1), podman-machine(1)

HISTORY

       February      2022,      Originally      compiled     by     Jason     Greene     jason.greene@redhat.com
       ⟨mailto:jason.greene@redhat.com⟩

                                                                                           podman-machine-set(1)