This repo is for the reporting of issues found within and when using Windows Subsystem for Linux.
- Do not open Github issues for Windows crashes (BSODs) or security issues. Please direct all Windows crashes and security issues to secure@microsoft.com. Issues with security vulnerabilities may be edited to hide the vulnerability details.
Note that WSL distro's launch in the Windows Console (unless you have taken steps to launch a 3rd party console/terminal). Therefore, please file UI/UX related issues in the Windows Console issue tracker.
This and our User Voice page are your best ways to interact directly with the Windows Subsystem for Linux teams. We will be monitoring and responding to issues as best we can. Please attempt to avoid filing duplicates of open or closed items when possible. In the spirit of openness we will be tagging issues with the following:
-
bug – We consider this issue to be a bug internally. This tag is generally for bugs in implemented features, or something we consider to be a “bug level” change. Things marked with Bug have a corresponding bug in on Microsoft’s internal bug tracking system.
- Example: No internet connectivity in Bash (#5)
-
feature – Denotes something that is not yet implemented. The community should use our User Voice page for voting on which features everyone feels as the most important. The team will take the User Voice page as input in deciding what to work on next.
- Example: Docker is not working (#85)
-
discussion – Denotes a discussion on the board that does not relate to a specific feature.
- Example: Windows Subsystem for Linux is not open source (#178)
-
fixinbound – When possible, we will mark bugs that have been fixed internally. Unfortunately we cannot say specifically when the bug will hit the insider flights.
-
bydesign – Denotes that an issue is raised that we consider is working as intended. We will give some reasoning why this is by design. After one week we will either close the issue or mark as Discussion depending on what comes up.
Additional tags may be used to denote specific types of issues. These include items such as network or symlink.
Issues may be closed by the original poster at any time. We will close issues if:
- One week passes after the change goes out to the Insider Fast ring
- An issue is clearly a dup of another. The duplicate will be linked
- Any discussion that has clearly run its course
- Stack Overflow: https://stackoverflow.com/questions/tagged/wsl
- Ask Ubuntu: https://askubuntu.com/questions/tagged/wsl
- reddit: https://www.reddit.com/r/bashonubuntuonwindows
- List of programs that work and don't work
- Awesome WSL: https://github.com/sirredbeard/Awesome-WSL
- Tips and guides for new bash users: https://github.com/abergs/ubuntuonwindows
Common troubleshooting issues and solutions are available on our MSDN documentation.