1podman-machine-set(1)       General Commands Manual      podman-machine-set(1)
2
3
4

NAME

6       podman-machine-set - Set a virtual machine setting
7
8

SYNOPSIS

10       podman machine set [options] [name]
11
12

DESCRIPTION

14       Change a machine setting.
15
16
17       The  default  machine name is podman-machine-default. If a machine name
18       is not specified as an argument, then the settings will be  applied  to
19       podman-machine-default.
20
21
22       Rootless only.
23
24

OPTIONS

26   --cpus=number
27       Number of CPUs.  Only supported for QEMU machines.
28
29
30   --disk-size=number
31       Size  of  the disk for the guest VM in GB.  Can only be increased. Only
32       supported for QEMU machines.
33
34
35   --help
36       Print usage statement.
37
38
39   --memory, -m=number
40       Memory (in MB).  Only supported for QEMU machines.
41
42
43   --rootful
44       Whether this machine prefers rootful (true) or  rootless  (false)  con‐
45       tainer execution. This option updates the current podman remote connec‐
46       tion default if it is currently pointing at the specified machine  name
47       (or podman-machine-default if no name is specified).
48
49
50   --user-mode-networking
51       Indicates  that  this  machine  relays traffic from the guest through a
52       user-space process running on the host. In some VPN configurations  the
53       VPN  may  drop  traffic from alternate network interfaces, including VM
54       network devices. By enabling user-mode networking (a setting of  true),
55       VPNs  observe  all  podman machine traffic as coming from the host, by‐
56       passing the problem.
57
58
59       When the qemu backend is used (Linux,  Mac),  user-mode  networking  is
60       mandatory  and  the  only  allowed value is true. In contrast, The Win‐
61       dows/WSL backend defaults to false, and follows the standard  WSL  net‐
62       work  setup.  Changing this setting to true on Windows/WSL informs Pod‐
63       man to replace the WSL networking setup on start of  this  machine  in‐
64       stance  with  a user-mode networking distribution. Since WSL shares the
65       same kernel  across  distributions,  all  other  running  distributions
66       reuses  this  network.  Likewise, when the last machine instance with a
67       true setting stops, the original networking setup is restored.
68
69
70       Unlike [podman system connection default] this  option  makes  the  API
71       socket, if available, forward to the rootful/rootless socket in the VM.
72
73

EXAMPLES

75       To  switch the default VM podman-machine-default from rootless to root‐
76       ful:
77
78
79              $ podman machine set --rootful
80
81
82
83       or more explicitly:
84
85
86              $ podman machine set --rootful=true
87
88
89
90       To switch the default VM podman-machine-default from rootful  to  root‐
91       less:
92
93
94              $ podman machine set --rootful=false
95
96
97
98       To switch the VM myvm from rootless to rootful:
99
100
101              $ podman machine set --rootful myvm
102
103
104

SEE ALSO

106       podman(1), podman-machine(1)
107
108

HISTORY

110       February  2022,  Originally  compiled by Jason Greene jason.greene@red‐
111       hat.com ⟨mailto:jason.greene@redhat.com⟩
112
113
114
115                                                         podman-machine-set(1)