Main > Live (#1937)

* Fixing small formatting and writing errors. (#1863)

* Fix broken code block and bookmark link (#1866)

* Fix broken code block

* Update broken wslconfig bookmark

* Update install-on-server.md (#1871)

Fix indent and numbering for better readability.

* Fix punctuation errors (#1876)

* small improvements in troubleshooting.md (#1877)

Some small formatting improvements.
Also added the command to restart the hns service.

* Fix a few typos (#1879)

Co-authored-by: Matt Wojciakowski <mattwoj@microsoft.com>

* Updated guide to fix an issue because of a wrong command (#1884)

* Update wsl-containers.md

Running Dev Containers: **Open Folder in Container...** when using this guide is not / no longer correct, as most readers will already have opened the folder while connected to WSL based on the steps provided above. We need to use **Dev Containers: Reopen in Container** or it will fail to create the .devcontainer folder and devcontainer.json and give a (unfortunately not very clear) error message.


See also: https://code.visualstudio.com/docs/devcontainers/containers#_open-a-wsl-2-folder-in-a-container-on-windows
   
- Use the Dev Containers: Reopen in Container command from a folder already opened using the WSL extension.
- Select Dev Containers: Open Folder in Container... from the Command Palette (F1) and choose a WSL folder using the local \\wsl$ share (from the Windows side).

* Update wsl-containers.md

---------

Co-authored-by: Matt Wojciakowski <mattwoj@microsoft.com>

* Update faq.yml -- tiny grammar change (#1885)

* Update faq.yml -- tiny grammar change 

'changes to locale to' -> 'changes the locale to'

* Update basic-commands.md

'If you running WSL' -> 'If you run WSL'

* Update basic-commands.md

* rephrase a long sentence
* swap order of two sentences to make example of command closer to the description of the command

example of command: `wsl --set-default-version 2`

* Update basic-commands.md

Replace 

wsl -u <Username>`, `wsl --user <Username>

with

wsl --user <Username>

`wsl -u <Username>` and `wsl --user <Username>` are equivalent. Both commands are correct for the section of the documentation, but the display of the commands in the documentation was incorrect due to the stray ticks and comma.

* Update gui-apps.md to simplify commits. (#1880)

* Update gui-apps.md

If we are already referencing apt, why not just use apt to install google chrome?

* Update gui-apps.md

forgot --fix-missing

* Add a note to explain the command flags and path

---------

Co-authored-by: Matt Wojciakowski <mattwoj@microsoft.com>

* Fix anchor warning

* Updated docs for usbipd-win updates (#1870)

* Updated docs for usbipd-win updates

* Update url to latest

Co-authored-by: Frans van Dorsselaer <17404029+dorssel@users.noreply.github.com>

* Fixes based on feedback

Thank you @dorssel !

* Remove admin requirement

Co-authored-by: Frans van Dorsselaer <17404029+dorssel@users.noreply.github.com>

* Remove x86 support

Co-authored-by: Frans van Dorsselaer <17404029+dorssel@users.noreply.github.com>

---------

Co-authored-by: Matt Wojciakowski <mattwoj@microsoft.com>
Co-authored-by: Frans van Dorsselaer <17404029+dorssel@users.noreply.github.com>

* Moving experimental settings to the experimental section (#1901)

* Moving experimental settings to the experimental section

Some networking config settings are still experimental. Moving those to the experimental section of the document so customers know how to use these settings.

* Added code ticks to new setting entries

* Update wsl-config.md

fixing settings which are no longer experimental, but the text still referred to them as experimental

* Update wsl-config.md

fixed the string referring to autoProxy. it's no longer experimental.

---------

Co-authored-by: Matt Wojciakowski <mattwoj@microsoft.com>

* Moving ms.prod and ms.technology to ms.service and ms.subservice

* Update to new feedback mechanism (#1917)

* Update to new feedback mechanism

* fix desc syntax

* Fix template link

* add svg support

* Update wsl-config.md to document the dnsProxy option (#1920)

dnsProxy is a wls2 configuration option which we need to document for customers that need to turn off the NAT DNS proxy.

* User/chdhan/networking doc update 2/21/24 (#1928)

* Signed-off-by: Chanpreet Dhanjal <chdhan@microsoft.com>

* updating troubleshooting page.

* Updating troubleshooting guide

* updating troubleshooting guide

* Editorial update, added explainer

* Update image alt text for accessibility

---------

Co-authored-by: Matt Wojciakowski <mattwoj@microsoft.com>

* Fix typo (#1924)

Github -> GitHub

* Fix typo (#1923)

Github -> GitHub

* Removed mention of deprecated content (#1915)

* FAQ: Split Hyper-V and Windows Home questions into two (#1914)

* FAQ: Split Hyper-V and Windows Home questions into two

Fixes #899

* FAQ: clarify WSL features need to be enabled

* Update wsl-plugins.md (#1913)

* Import export command clarification (#1910)

* Split the import and export commands into separate sections

- My original intent was to clarify that the export command exports a **snapshot** of the specified distribution. The way it is currently written doesn't say otherwise, but it could be interpreted to mean it exports a clean install without the user's modifications. 

    - In other words, it could be saying `wsl --export Ubuntu ubuntu.tar` is equivalent to downloading the official "ubuntu.tar" from the internet. 
- Splitting these two was not part of my original goal, merely a step along the way to achieve it.
- I decided to make this its own commit so that it can be `cherry-pick`ed if it provides value on its own but the upcoming commits do not.

* Specify that the export command exports a snapshot

* Fix orphan links to import/export command sections

* fix ambiguous wording for required win version (#1895)

Previously the docs stated that Windows version 22H2 was required, but that is wrong: microsoft/WSL#10853

it is specifically Windows *11* version 22H2 that is required.

* Updating troubleshooting page

* User/chdhan/wsl troubleshooting doc update 3 18 23 (#1936)

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

---------

Co-authored-by: Stefan Nikolaj <51296436+snikolaj@users.noreply.github.com>
Co-authored-by: Anton Kesy <antonkesy@gmail.com>
Co-authored-by: Ishan Jain <github@ishan.jain.se>
Co-authored-by: Krishna Vivek Vitta <84629581+krishnacx@users.noreply.github.com>
Co-authored-by: icyerasor <andreas@feldschmid.com>
Co-authored-by: Blake-Madden <66873089+Blake-Madden@users.noreply.github.com>
Co-authored-by: vmsteiner <107506233+vmsteiner@users.noreply.github.com>
Co-authored-by: Andrew Zipperer <47086307+zipperer@users.noreply.github.com>
Co-authored-by: Wes Bryie <wes@wesbryie.tech>
Co-authored-by: Craig Loewen <crloewen@microsoft.com>
Co-authored-by: Frans van Dorsselaer <17404029+dorssel@users.noreply.github.com>
Co-authored-by: Keith Horton <khorton@microsoft.com>
Co-authored-by: Drew Batchelor (he/him) <drewbat@microsoft.com>
Co-authored-by: chanpreetdhanjal <68442928+chanpreetdhanjal@users.noreply.github.com>
Co-authored-by: Takashi Takebayashi <changeworld@users.noreply.github.com>
Co-authored-by: Patrick Brosset <patrickbrosset@gmail.com>
Co-authored-by: Daniel Kaplan <tieTYT@gmail.com>
Co-authored-by: Saisang Cai <Saisang@users.noreply.github.com>
Co-authored-by: jantari <jantari@outlook.de>
Co-authored-by: Chanpreet Dhanjal <chdhan@microsoft.com>

WSL/networking.md

@@ -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)

WSL/troubleshooting.md

@@ -436,6 +436,10 @@ This is a flaw within HNS which has been fixed with the latest Windows 11 releas
   ```Restart-Service hns```
 - When WSL is restarted, HNS will create new Firewall rules, correctly targeting the WSL interface.
 
+### Troubleshooting Network Access Issues on Windows
+
+If you have no network access, it might be due to a misconfiguration. Please see if the FSE driver is running: ‘sc queryex FSE’. If that does not show FSE running, please check if the PortTrackerEnabledMode registry value exits under this registry key: reg query HKLM\System\CurrentControlSet\Services\Tcpip\Parameters. If FSE is not running or installed, and PortTrackerEnabledMode exists, please delete that registry value and reboot
+
 ### Manual way to delete phantom adapters
 
 *Ghost adapters*, or phantom Plug and Play (PnP) devices, refer to hardware components that appear in your system but are not physically connected. These “ghost” devices can cause confusion and clutter in your system settings. If you see ghost adapters when running WSL in a Virtual Machine (VM), follow these manual steps to find and delete these Phantom PnP devices. Microsoft is working on an automated solution that will not require manual intervention. More information will be coming soon.

WSL/wsl-config.md

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