Ubuntu on WSL will not start and shows error 0x800701bc
WslRegisterDistribution failed with error: 0x800701bcShort 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.
Fix it fast
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 --version2Match what you see, then jump to its fix
- 1
The error mentions the kernel component, or wsl --version reports an old WSL releaseThe WSL kernel component is out of dateFix - 2
Manual 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
wsl --set-default-version 2 prints Error: 0x1bc and nothing elseOnly the code is shown because the display language is not EnglishFix
- 1
What does the error look like?
WslRegisterDistribution failed with error: 0x800701bcError: 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 --version2Fix
Update WSL, stop the WSL virtual machine, then launch the distribution again.
wsl --update
wsl --shutdown3Verify
Start the distribution.
wsl --list --verboseConfirmed by learn.microsoft.com
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 23Verify
The command prints no error, and the distribution opens.
wsl --list --verboseConfirmed by learn.microsoft.com
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 22Fix
Apply the update from the first cause; the language setting does not need to change.
wsl --update3Verify
The default-version command now succeeds.
wsl --set-default-version 2Confirmed by learn.microsoft.com
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 fixServers
Ansible hangs, then times out waiting for the sudo prompt
a playbook using become seems to hang
Ansible ran sudo on the target and never saw the answer it expected.
3 causes, each with a fixServers
Apache on Ubuntu returns 404 Not Found for my site
The requested URL was not found on this server.
On Ubuntu a 404 from Apache usually means the request maps to a path that has no file.
3 causes, each with a fixServers
Apache returns 504 Gateway Timeout when PHP takes too long
Quick requests work, slow ones end in a 504 after a fixed wait
A 504 from Apache means the backend did not answer within the proxy timeout.
2 causes, each with a fixServers
Apache logs SIGWINCH and exits on its own
the httpd container stops although nothing crashed
SIGWINCH is Apache's graceful-stop signal.
2 causes, each with a fixServers
Apache warns that a ${VAR} config variable is not defined
${VAR} left unchanged in the configuration, with a warning in the error log
Apache expands ${VAR} from Define or from the shell environment that exists when the server starts.
3 causes, each with a fix