Skip to content

Commit a9e80f9

Browse files
Merge pull request #26785 from Luap99/user-mode-docs
make machine --user-mode-networking docs more clear
2 parents 5599613 + 5706d2a commit a9e80f9

File tree

1 file changed

+11
-8
lines changed

1 file changed

+11
-8
lines changed

docs/source/markdown/options/user-mode-networking.md

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,18 +4,21 @@
44
####> are applicable to all of those.
55
#### **--user-mode-networking**
66

7-
Indicates that this machine relays traffic from the guest through a user-space
8-
process running on the host. In some VPN configurations the VPN may drop
9-
traffic from alternate network interfaces, including VM network devices. By
10-
enabling user-mode networking (a setting of `true`), VPNs observe all
11-
podman machine traffic as coming from the host, bypassing the problem.
7+
This option can only be used for the WSL provider on Windows. On all other
8+
platforms this option is ignored and user mode networking will always be
9+
`true` there because these providers always depend on gvproxy (our user
10+
mode networking tool for the VMs)
1211

13-
When the qemu backend is used (Linux, Mac), user-mode networking is
14-
mandatory and the only allowed value is `true`. In contrast, The Windows/WSL
15-
backend defaults to `false`, and follows the standard WSL network setup.
12+
In contrast, The Windows/WSL backend defaults to `false`, and follows the
13+
standard WSL network setup.
1614
Changing this setting to `true` on Windows/WSL informs Podman to replace
1715
the WSL networking setup on start of this machine instance with a user-mode
1816
networking distribution. Since WSL shares the same kernel across
1917
distributions, all other running distributions reuses this network.
2018
Likewise, when the last machine instance with a `true` setting stops, the
2119
original networking setup is restored.
20+
21+
In some VPN configurations the VPN may drop traffic from alternate network
22+
interfaces, including VM network devices. By enabling user-mode networking
23+
VPNs observe all podman machine traffic as coming from the host, bypassing
24+
the problem.

0 commit comments

Comments
 (0)