WSL 0x800701bc Error: Ubuntu Installation Fix

Problem Statement

When attempting to install Ubuntu 22.04 LTS (or other Linux distributions) on Windows Subsystem for Linux (WSL), users may encounter the error:

WslRegisterDistribution failed with error: 0x800701bc

This error typically indicates that WSL cannot properly initialize the Linux distribution due to missing components, outdated kernel, or incorrect system configuration.

Primary Solutions

1. Update WSL Kernel

The most common fix is updating the WSL kernel to the latest version:

PowerShell

# Update WSL kernel
wsl --update

# Install Ubuntu after update
wsl --install -d ubuntu

Alternative Method

# Set WSL 2 as default version
wsl --set-default-version 2

2. Enable Required Windows Features

WSL requires specific Windows features to be enabled:

1. Open "Turn Windows features on or off" (search in Start menu)
2. Enable both:
   • Virtual Machine Platform
   • Windows Subsystem for Linux
3. Restart your computer

3. Manual Kernel Extraction (Advanced)

If automatic installation fails, manually extract and place the kernel:

Command Prompt

# Extract kernel from MSI package
msiexec /a "wsl_update_x64.msi" /qb TARGETDIR="C:\temp"

Then copy the kernel file from C:\temp to C:\Windows\System32\lxss\tools

Common WSL Commands

After successful installation, use these commands to manage your WSL environment:

List installed distros

wsl --list

List available distros

wsl --list --online

Install specific distro

wsl --install Ubuntu-22.04

Set default distro

wsl --set-default Ubuntu

Uninstall distro

wsl --unregister Ubuntu

Troubleshooting Tips

WARNING

Ensure your CPU supports virtualization and it's enabled in BIOS/UEFI settings. This is required for WSL 2 functionality.

INFO

If you encounter error 0x80370114 ("a required feature is not installed"), it typically indicates the same underlying issue as 0x800701bc - missing Windows features or kernel components.

System Requirements

• Windows 10 version 2004 or higher (Build 19041+)
• Windows 11 (all versions)
• CPU with virtualization support (Intel VT-x or AMD-V)

Environment Verification

The solutions have been tested on various configurations including:

• CPU: AMD Ryzen 9 6900HX and Intel processors
• OS: Windows 11 Home 22H2, Windows 10 20H2+

These steps should resolve the 0x800701bc error and allow successful Ubuntu installation on WSL. If issues persist, consider checking Microsoft's official WSL documentation for the latest updates and troubleshooting guidance.