Skip to content

Commit

Permalink
Update troubleshooting.md when Network Manager is running (#1943)
Browse files Browse the repository at this point in the history
* Update troubleshooting.md when Network Manager is running

There are known incompatibilities when the Network Manager service is running within the Linux container. This documents this issue and how to stop that service.

* Update troubleshooting.md

fixing misspelling
  • Loading branch information
keith-horton committed Apr 9, 2024
1 parent f358266 commit f4900a4
Showing 1 changed file with 9 additions and 0 deletions.
9 changes: 9 additions & 0 deletions WSL/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -320,6 +320,15 @@ WSL will automatically configure certain Linux networking settings when using mi

There is a known issue in which Docker Desktop containers with published ports (docker run –publish/-p) will fail to be created. The WSL team is working with the Docker Desktop team to address this issue. To work around the issue, use the host’s networking namespace in the Docker container. Set the network type via the "--network host" option used in the "docker run" command. An alternative workaround is to list the published port number in the `ignoredPorts` setting of the [experimental section in the WSL Configuration file](/windows/wsl/wsl-config#experimental-settings).

### Docker container issues when its Network Manager is running

There is a known issue with Docker containers which have the Network Manager service running. Symptoms include failures when trying to make loopback connections to the host.
It is recommended to stop the Network Manager service for WSL networking to be configured properly.

```Bash
sudo systemctl disable network-manager.service
```

### DNS suffixes in WSL

Depending on the configurations in the .wslconfig file, WSL will have the following behavior wrt DNS suffixes:
Expand Down

0 comments on commit f4900a4

Please sign in to comment.