Skip to content

Commit

Permalink
User/chdhan/wsl troubleshooting doc update 3 18 23 (#1936)
Browse files Browse the repository at this point in the history
* Signed-off-by: Chanpreet Dhanjal <chdhan@microsoft.com> Upating pages to reflect support for IPV4 and IPV6

* Updated text

* Minor editorial update

We try to only use "note:" to indicate actual formatted notes.

* Minor editorial updates

---------

Co-authored-by: Matt Wojciakowski <mattwoj@microsoft.com>
  • Loading branch information
chanpreetdhanjal and mattwojo committed Mar 20, 2024
1 parent 86394f4 commit 71097ab
Show file tree
Hide file tree
Showing 2 changed files with 3 additions and 3 deletions.
2 changes: 1 addition & 1 deletion WSL/networking.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ You can [set `networkingMode=mirrored` under `[wsl2]` in the `.wslconfig` file](
Here are the current benefits to enabling this mode:

- IPv6 support
- Connect to Windows servers from within Linux using the localhost address `127.0.0.1`
- Connect to Windows servers from within Linux using the localhost address `127.0.0.1`. IPv6 localhost address `::1` is not supported
- Improved networking compatibility for VPNs
- Multicast support
- Connect to WSL directly from your local area network (LAN)
Expand Down
4 changes: 2 additions & 2 deletions WSL/wsl-config.md
Original file line number Diff line number Diff line change
Expand Up @@ -249,7 +249,7 @@ These settings are opt-in previews of experimental features that we aim to make
|`bestEffortDnsParsing`**| bool | false | Only applicable when `wsl2.dnsTunneling` is set to true. When set to true, Windows will extract the question from the DNS request and attempt to resolve it, ignoring the unknown records. |
|`initialAutoProxyTimeout`*| string | 1000 | Only applicable when `wsl2.autoProxy` is set to true. Configures how long (in milliseconds) WSL will wait for retrieving HTTP proxy information when starting a WSL container. If proxy settings are resolved after this time, the WSL instance must be restarted to use the retrieved proxy settings. |
|`ignoredPorts`**| string | null | Only applicable when `wsl2.networkingMode` is set to `mirrored`. Specifies which ports Linux applications can bind to, even if that port is used in Windows. This enables applications to listen on a port for traffic purely within Linux, so those applications are not blocked even when that port is used for other purposes on Windows. For example, WSL will allow binding to port 53 in Linux for Docker Desktop, as it is listening only to requests from within the Linux container. Should be formatted in a comma separated list, e.g: `3000,9000,9090` |
|`hostAddressLoopback`**| bool | false | Only applicable when `wsl2.networkingMode` is set to `mirrored`. When set to True, will allow the Container to connect to the Host, or the Host to connect to the Container, by an IP address that's assigned to the Host. Note that the 127.0.0.1 loopback address can always be used - this option allows for all additionally assigned local IP addresses to be used as well. |
|`hostAddressLoopback`**| bool | false | Only applicable when `wsl2.networkingMode` is set to `mirrored`. When set to `True`, will allow the Container to connect to the Host, or the Host to connect to the Container, by an IP address that's assigned to the Host. The `127.0.0.1` loopback address can always be used,this option allows for all additionally assigned local IP addresses to be used as well. Only IPv4 addresses assigned to the host are supported. |

Entries with an * after the value type are only available on Windows 11.

Expand Down Expand Up @@ -284,7 +284,7 @@ swapfile=C:\\temp\\wsl-swap.vhdx
# Disable page reporting so WSL retains all allocated memory claimed from Windows and releases none back when free
pageReporting=false

# Turn on default connection to bind WSL 2 localhost to Windows localhost
# Turn on default connection to bind WSL 2 localhost to Windows localhost. Setting is ignored when networkingMode=mirrored
localhostforwarding=true

# Disables nested virtualization
Expand Down

0 comments on commit 71097ab

Please sign in to comment.