Troubleshooting WSL_E_DEFAULT_DISTRO_NOT_FOUND Error on Windows Subsystem for Linux

Are you encountering the WSL_E_DEFAULT_DISTRO_NOT_FOUND error when trying to use the Windows Subsystem for Linux (WSL)? Don't worry, you're not alone. This error typically occurs when the default Linux distribution is missing or corrupted. In this article, we will guide you through the troubleshooting steps to resolve this error and get your WSL up and running smoothly again.

What is WSL_E_DEFAULT_DISTRO_NOT_FOUND error?

The WSL_E_DEFAULT_DISTRO_NOT_FOUND error is a common issue faced by Windows users who are trying to use the Windows Subsystem for Linux. This error message indicates that the default Linux distribution cannot be found on your system. It may occur due to a variety of reasons, including an incomplete installation, a corrupted distribution, or an issue with the WSL configuration.

How to troubleshoot WSL_E_DEFAULT_DISTRO_NOT_FOUND error?

Follow these step-by-step instructions to troubleshoot and fix the WSL_E_DEFAULT_DISTRO_NOT_FOUND error:

Step 1: Check WSL installation

First, ensure that you have WSL installed on your Windows system. To do this, follow these steps:

1. Open the Windows PowerShell or Command Prompt as an administrator.
2. Type the following command and press Enter: wsl --list --verbose
3. If you see a list of installed distributions, it means WSL is installed correctly. If not, you need to install WSL by following the official Microsoft documentation.

Step 2: Set a default distribution

If you have multiple Linux distributions installed, you need to set a default distribution. Here's how:

1. Open the Windows PowerShell or Command Prompt as an administrator.
2. Type the following command and press Enter: wsl --set-default
3. Replace <distribution_name> with the name of the distribution you want to set as default.

Step 3: Uninstall and reinstall the Linux distribution

If the default Linux distribution is missing or corrupted, you may need to uninstall and reinstall it. Follow these steps:

1. Open the Windows PowerShell or Command Prompt as an administrator.
2. Type the following command and press Enter: wsl --unregister
3. Replace <distribution_name> with the name of the distribution you want to uninstall.
4. Once uninstalled, reinstall the Linux distribution from the Microsoft Store or by using the wsl --install command.

Step 4: Reset WSL

If the above steps didn't resolve the issue, you can try resetting the WSL configuration. Here's how:

1. Open the Windows PowerShell or Command Prompt as an administrator.
2. Type the following command and press Enter: wsl --shutdown
3. Wait for the command to complete, then restart your computer.
4. After restarting, open PowerShell or Command Prompt as an administrator again.
5. Type the following command and press Enter: wsl --set-version 2
6. Replace <distribution_name> with the name of the distribution you want to reset.

Step 5: Update Windows and WSL

Make sure you have the latest updates installed for both Windows and WSL. To update Windows, go to Settings > Update & Security > Windows Update and click on "Check for updates." To update WSL, open the Microsoft Store, search for your Linux distribution, and click on "Update."

Following these troubleshooting steps should help you resolve the WSL_E_DEFAULT_DISTRO_NOT_FOUND error and get your Windows Subsystem for Linux working again. If you continue to experience issues, it may be helpful to seek further assistance from the Microsoft community forums or consult the official Microsoft documentation.

References