Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 11 additions & 8 deletions docs/source/markdown/options/user-mode-networking.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,18 +4,21 @@
####> are applicable to all of those.
#### **--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.
This option can only be used for the WSL provider on Windows. On all other
platforms this option is ignored and user mode networking will always be
`true` there because these providers always depend on gvproxy (our user
mode networking tool for the VMs)

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.
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.

In some VPN configurations the VPN may drop traffic from alternate network
interfaces, including VM network devices. By enabling user-mode networking
VPNs observe all podman machine traffic as coming from the host, bypassing
the problem.