Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages
Servers, nginx and Docker

Ubuntu on WSL will not start and shows error 0x800701bc

ErrorWslRegisterDistribution failed with error: 0x800701bc

Short answer

Error 0x800701bc is the code for the message that WSL 2 needs an update to its kernel component. Update WSL from PowerShell with wsl --update, then restart WSL with wsl --shutdown. On a manual Windows 10 setup, reinstall the Linux kernel update package if the kernel file is missing.

  • Applies to Windows 11, Windows 10 22H2, WSL 2, Ubuntu 24.04 distribution
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Fix it fast

  1. 1Find out which cause you have

    Read the WSL version and the kernel it reports. If the command fails or shows no kernel, the kernel component is the problem.

    wsl --status
    wsl --version
  2. 2Match what you see, then jump to its fix

    1. 1The error mentions the kernel component, or wsl --version reports an old WSL releaseThe WSL kernel component is out of dateFix
    2. 2Manual WSL 2 setup, and the lxss tools folder under the Windows system folder has no kernel fileThe kernel package is missing from the system folderFix
    3. 3wsl --set-default-version 2 prints Error: 0x1bc and nothing elseOnly the code is shown because the display language is not EnglishFix

What does the error look like?

  • WslRegisterDistribution failed with error: 0x800701bc
  • Error: 0x800701bc WSL 2 requires an update to its kernel component.

Cause 1 of 3

The WSL kernel component is out of date

1Check

Microsoft documents 0x1bc as the code for WSL 2 requiring an update to its kernel component.

wsl --version

2Fix

Update WSL, stop the WSL virtual machine, then launch the distribution again.

wsl --update
wsl --shutdown

3Verify

Start the distribution.

wsl --list --verbose

Confirmed by learn.microsoft.com

Did this fix it?

Cause 2 of 3

The kernel package is missing from the system folder

1Check

If the Linux kernel package is missing from %SystemRoot%\system32\lxss\tools, WSL 2 raises this error.

dir "%SystemRoot%\system32\lxss\tools"

2Fix

Install the Linux kernel update MSI package from the manual install steps. If it is already installed, uninstall it in Add or Remove Programs and install it again. Then set WSL 2 as the default version.

wsl --set-default-version 2

3Verify

The command prints no error, and the distribution opens.

wsl --list --verbose

Confirmed by learn.microsoft.com

Did this fix it?

Cause 3 of 3

Only the code is shown because the display language is not English

1Check

Microsoft notes this can happen when the Display Language or System Locale is not English. The code still means the kernel component update.

wsl --set-default-version 2

2Fix

Apply the update from the first cause; the language setting does not need to change.

wsl --update

3Verify

The default-version command now succeeds.

wsl --set-default-version 2

Confirmed by learn.microsoft.com

Did this fix it?

How do I stop it coming back?

  • Keep WSL updated with wsl --update, not only Windows Update.
  • Run wsl --shutdown after a WSL update before opening Docker Desktop.
  • Install WSL with wsl --install so the kernel arrives with it.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.

Which stack is behind this page?

Related fixes

Servers

dnf cannot install MySQL on Amazon Linux 2023

dnf cannot find a mysql-server package on Amazon Linux 2023

Amazon Linux 2023 documents MariaDB, not MySQL, as its database server, with packages named mariadb105 and mariadb105-server.

3 causes, each with a fix

Next step

Want this handled for good?

I look after servers, apps and releases end to end. Tell me what keeps breaking.