Explorador
Chuleta

Requisitos previos de WSL 2

Las cuatro cosas que deben cumplirse antes de instalar, cómo comprobar cada una desde PowerShell y qué error aparece cuando falta.

Actualizado el

En esta guía

Activar la virtualización en la BIOS es necesario, pero no basta. WSL 2 necesita cuatro cosas, y cada una se comprueba por separado.

Lista de comprobación

# Requisito Dónde se activa
1 Versión de Windows compatible Windows Update
2 Virtualización activa en el firmware y CPU con SLAT BIOS / UEFI
3 Características Plataforma de máquina virtual y Subsistema de Windows para Linux Características de Windows
4 Hipervisor habilitado en el arranque Configuración de arranque (bcdedit)

wsl --install se encarga del punto 3 por sí solo. Los puntos 1, 2 y 4 no los resuelve.

Lo que hay que activar son características de Windows (componentes opcionales), no servicios. No hay nada que tocar en services.msc.

1. Versión de Windows

Sistema Mínimo para wsl --install
Windows 11 Cualquier versión
Windows 10 Versión 2004 (build 19041) o posterior
winver

En builds más antiguos de Windows 10 (desde la 1903, build 18362.1049) WSL 2 funciona, pero solo con la instalación manual.

2. Virtualización en el firmware

(Get-CimInstance Win32_Processor).VirtualizationFirmwareEnabled

Debe devolver True. Si devuelve False, hay que activarla en la BIOS: los pasos están en verificar y activar la virtualización.

Además, el procesador debe soportar SLAT (Second Level Address Translation). Lo tienen todos los Intel Core desde la primera generación y los AMD equivalentes. Un procesador anterior, como un Core 2 Duo, no puede ejecutar WSL 2 aunque todo lo demás esté activado.

3. Características de Windows

WSL 2 depende de dos componentes opcionales:

Característica Nombre interno Para qué sirve
Plataforma de máquina virtual VirtualMachinePlatform Ejecuta la máquina virtual ligera donde corre el kernel de Linux
Subsistema de Windows para Linux Microsoft-Windows-Subsystem-Linux El propio WSL

No hace falta activar la característica Hyper-V completa. Con Plataforma de máquina virtual es suficiente, y por eso WSL 2 funciona también en Windows Home.

Comprobar el estado

En PowerShell como administrador:

Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform
Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

En cada salida, State debe ser Enabled.

Activarlas con wsl

wsl --install --no-distribution

Activa ambas sin instalar ninguna distro.

Activarlas con dism

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Activarlas desde la interfaz

Menú Inicio → buscar Activar o desactivar las características de Windows → marcar Plataforma de máquina virtual y Subsistema de Windows para Linux → Aceptar.

Con cualquiera de los tres métodos hay que reiniciar el equipo. Hasta entonces las características figuran como activadas pero no funcionan.

4. Hipervisor en el arranque

Aunque las características estén activas, el hipervisor puede estar deshabilitado en la configuración de arranque. Suele pasar si alguna vez se desactivó para usar VirtualBox, VMware o un emulador.

bcdedit /enum | findstr -i hypervisorlaunchtype

Si muestra hypervisorlaunchtype Off, se habilita así (PowerShell como administrador) y se reinicia:

bcdedit /set hypervisorlaunchtype Auto

Otros hipervisores

VMware y VirtualBox conviven con WSL 2 solo en versiones que soportan Hyper-V: VMware Workstation 15.5.5 o posterior y VirtualBox 6 o posterior. Las versiones anteriores hay que actualizarlas o dejar de usarlas.

Dentro de una máquina virtual

Si Windows corre a su vez dentro de una máquina virtual, el anfitrión debe exponer la virtualización anidada. En Hyper-V, desde el anfitrión:

Set-VMProcessor -VMName <NombreVM> -ExposeVirtualizationExtensions $true

Errores y qué requisito falta

Error Causa habitual Revisar
0x80370102 La máquina virtual no puede arrancar: falta la virtualización, la Plataforma de máquina virtual o el hipervisor Puntos 2, 3 y 4
0x80070003 Virtualización desactivada en la BIOS o CPU sin SLAT Punto 2
0x8007019e La característica Subsistema de Windows para Linux no está activada Punto 3
wsl --install muestra la ayuda WSL ya está instalado wsl --install -d <Distro>
La instalación se queda en 0.0 % Fallo al descargar desde la Store wsl --install --web-download -d <Distro>

Comprobación final

Con los cuatro puntos resueltos y el equipo reiniciado:

wsl --status
wsl --update

Si ambos responden sin errores, se puede pasar a instalar WSL y la primera distro.

Fuente: documentación oficial de Microsoft, instalación, instalación manual y solución de problemas.