Instalar WSL2 en Windows 11 paso a paso (y los tres errores que más se repiten)

Instalar WSL2 en Windows 11 es, sobre el papel, un solo comando. En la práctica, casi todas las consultas que nos llegan tienen que ver con tres errores que se repiten. Aquí va el proceso completo y cómo salir de cada uno.

Requisitos

• Windows 11 (cualquier edición) o Windows 10 versión 2004 o posterior.
• Virtualización activada en la BIOS/UEFI (Intel VT-x o AMD-V/SVM).
• Una cuenta con permisos de administrador.

Paso 1: el comando

Abre PowerShell o Terminal como administrador y ejecuta:

wsl --install

Este comando activa las características necesarias, descarga el núcleo de Linux, establece WSL2 como versión por defecto e instala Ubuntu. Reinicia cuando te lo pida.

Si prefieres otra distribución, consulta la lista y elige:

wsl --list --online
wsl --install -d Debian

Paso 2: primer arranque

Tras reiniciar, se abrirá una ventana que termina la instalación y te pide un nombre de usuario y una contraseña para Linux. No tienen que coincidir con los de Windows. Esa contraseña es la que te pedirá sudo.

Actualiza el sistema nada más entrar:

sudo apt update && sudo apt full-upgrade -y

Paso 3: comprobar que es WSL2

wsl -l -v

La columna VERSION debe decir 2. Si dice 1, conviértela con wsl --set-version Ubuntu 2.

Los tres errores que más se repiten

Error 0x80370102: la virtualización no está activada

Es el más habitual. Entra en la BIOS/UEFI y activa la opción de virtualización (puede llamarse Intel Virtualization Technology, VT-x, SVM Mode o AMD-V). En el Administrador de tareas, pestaña Rendimiento, CPU, debe aparecer «Virtualización: habilitado».

WslRegisterDistribution failed with error: 0x800701bc

Falta o está desactualizado el núcleo de Linux de WSL. Se arregla con:

wsl --update

La red no funciona dentro de WSL con la VPN de la empresa

Muchas VPN corporativas rompen la red de WSL2. En versiones recientes puedes activar el modo de red en espejo creando %UserProfile%\.wslconfig con:

[wsl2]
networkingMode=mirrored
dnsTunneling=true

Después, wsl --shutdown y vuelve a abrir la distribución.

Tres ajustes que recomendamos

• Limita la memoria si tu equipo tiene poca: en .wslconfig, memory=4GB.
• Trabaja dentro de Linux (~/proyectos) y no en /mnt/c: el acceso a los ficheros de Windows es mucho más lento.
• Instala Windows Terminal si no lo tienes; viene de serie en Windows 11.

La documentación oficial de Microsoft está en Microsoft Learn y se actualiza con cada versión.