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).
--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.
Unlike podman system connection default this option makes the API socket, if available, forward to the rootful/rootless socket in the VM.
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¶
HISTORY¶
February 2022, Originally compiled by Jason Greene jason.greene@redhat.com