microsoft / microsoft/WSL

Error code: Wsl/InstallDistro/Service/RegisterDistro/CreateVm/HCS/HCS_E_HYPERV_NOT_INSTALLED

Open
#12,734 10 comments 0 reactions 0 assignees View on GitHub
Dominant language
C++
Stars
33.7k
Forks
1.8k
Avg merge
3d 17h
Merged PRs (30d)
116

Description

### Windows Version

Microsoft Windows [Version 10.0.26100.3194]

### WSL Version

WSL version: 2.4.8.0

### Are you using WSL 1 or WSL 2?

- [x] WSL 2
- [ ] WSL 1

### Kernel Version

Kernel version: 5.15.167.4-1

### Distro Version

_No response_

### Other Software

_No response_

### Repro Steps

while installing wsl observing the error: HCS_E_HYPERV_NOT_INSTALLED [ though Bios has enabled with virtualisation ]

**Steps**:
```
wsl --install -d Ubuntu
Downloading: Ubuntu
Installing: Ubuntu
WSL2 is not supported with your current machine configuration.
Please enable the "Virtual Machine Platform" optional component and ensure virtualisation is enabled in the BIOS.
Enable "Virtual Machine Platform" by running: wsl.exe --install --no-distribution
For information please visit https://aka.ms/enablevirtualization
Error code: Wsl/InstallDistro/Service/RegisterDistro/CreateVm/HCS/HCS_E_HYPERV_NOT_INSTALLED

```
**info**:
**RestoreHealth**
```
PS C:\WINDOWS\system32> DISM /Online /Cleanup-Image /RestoreHealth

Deployment Image Servicing and Management tool
Version: 10.0.26100.1150

Image Version: 10.0.26100.3194

[==========================100.0%==========================] The restore operation completed successfully.
The operation completed successfully.

```

```
systeminfo

Virtualization-based security: Status: Running
Required Security Properties:
Available Security Properties:
Base Virtualization Support
Secure Boot
DMA Protection
Secure Memory Overwrite
UEFI Code Readonly
Mode Based Execution Control
APIC Virtualization
Services Configured:
Services Running:
App Control for Business policy: Enforced
App Control for Business user mode policy: Audit
Security Features Enabled:
Hyper-V Requirements: A hypervisor has been detected. Features required for Hyper-V will not be displayed.

```
**Windows Feature Stats:**
![Image](https://github.com/user-attachments/assets/f33ed7f9-d28c-4670-8238-dcad45b0262c)

**Logs attached:**
Logs [WslLogs-2025-03-23_21-48-51.zip](https://github.com/user-attachments/files/19411839/WslLogs-2025-03-23_21-48-51.zip)

### Expected Behavior

wsl should get installed.

### Actual Behavior

wsl installation failed.

```
wsl --install -d Ubuntu
Downloading: Ubuntu
Installing: Ubuntu
WSL2 is not supported with your current machine configuration.
Please enable the "Virtual Machine Platform" optional component and ensure virtualisation is enabled in the BIOS.
Enable "Virtual Machine Platform" by running: wsl.exe --install --no-distribution
For information please visit https://aka.ms/enablevirtualization
Error code: Wsl/InstallDistro/Service/RegisterDistro/CreateVm/HCS/HCS_E_HYPERV_NOT_INSTALLED

```

**LxssManager Stats: [No LxssManager -Even after sfc /scannow,]**
```
net start LxssManager
System error 2 has occurred.

The system cannot find the file specified.

Test-Path "C:\Windows\System32\lxss\LxssManager.dll"
False

sfc /scannow

Beginning system scan. This process will take some time.

Beginning verification phase of system scan.
Verification 100% complete.

Windows Resource Protection did not find any integrity violations.

DISM /Online /Cleanup-Image /RestoreHealth /Source:D:\Sources\SxS /LimitAccess

PS C:\WINDOWS\system32> Test-Path "C:\Windows\System32\lxss\LxssManager.dll"
False
PS C:\WINDOWS\system32>
PS C:\WINDOWS\system32> Test-Path "C:\Windows\System32\lxss\wslsupport.dll"
True
```
### Diagnostic Logs

**Logs attached:**
Logs [WslLogs-2025-03-23_21-48-51.zip](https://github.com/user-attachments/files/19411839/WslLogs-2025-03-23_21-48-51.zip)

Contributor guide

Open the contributing guide

Research direction

Start by reviewing the attached WslLogs-2025-03-23_21-48-51.zip and the outputs from `wsl --install -d Ubuntu`, `systeminfo`, and the Windows feature checks. Compare the reported HCS_E_HYPERV_NOT_INSTALLED failure with the missing LxssManager.dll described in the issue. Done means identifying a reproducible cause and a validated path for WSL to install Ubuntu successfully.

Written by the indexing model from the issue text.

Assessment

Domain
operating-systems
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.