Cómo instalar WSL2 en Windows 11 paso a paso

Introducción — ¿qué es WSL2 y por qué usarlo?

WSL2 (Windows Subsystem for Linux 2) es una capa de compatibilidad que permite ejecutar un kernel Linux real dentro de Windows, con mejor compatibilidad y rendimiento respecto a WSL1. Si quieres desarrollar con herramientas Linux (bash, gestores de paquetes, servicios, contenedores) sin máquina virtual pesada, esta guía explica cómo instalar WSL2 en Windows 11 paso a paso, verificar que funciona y resolver los problemas más comunes.

Intención de este artículo y requisitos previos

Objetivo: ofrecer un flujo rápido (comando único) y uno manual (por si falla) con comandos verificados, comprobaciones y soluciones prácticas. Requisitos previos mínimos:

• Windows 11 actualizado (ediciones soportadas). WSL también está disponible en Windows 10 recientes, pero aquí nos centramos en Windows 11.
• Virtualización habilitada en BIOS/UEFI (VT-x para Intel, AMD-V para AMD).
• Cuenta con permisos de administrador para ejecutar PowerShell/Command Prompt.

Comprobar la versión de Windows y requisitos mínimos

Abre Configuración > Sistema > Acerca de para confirmar la edición y versión. En su defecto, ejecuta:

winver

WSL en Windows 11 funciona en las ediciones soportadas; si tienes dudas, actualiza Windows antes de proceder.

Habilitar virtualización en BIOS/UEFI (qué buscar)

WSL2 necesita que la virtualización esté activa a nivel de firmware. Comprobaciones rápidas en Windows:

• Task Manager (Ctrl+Shift+Esc) > Performance > CPU: abajo verás «Virtualization: Enabled» o «Disabled».
• Símbolo del sistema: systeminfo y busca la sección «Hyper-V Requirements»; aparecerá «Virtualization Enabled In Firmware: Yes» si está activa.

Si está desactivada, reinicia y entra en la BIOS/UEFI (teclas típicas: F2, F10, Supr dependiendo del fabricante) y activa Intel VT-x / AMD-V (nombres como «Virtualization Technology», «SVM Mode» o similar). Si tu PC es una máquina virtual, asegúrate de que la nested virtualization está habilitada en el host.

Metodo rápido (recomendado): comando único wsl --install

La forma más sencilla es ejecutar PowerShell o CMD como administrador y lanzar:

wsl --install

Este comando habilita los componentes necesarios, descarga el kernel de WSL y, por defecto, instala WSL2 junto a la distribución predeterminada (normalmente Ubuntu). Puedes instalar una distribución concreta así:

wsl --install -d Ubuntu

Tras la ejecución suele ser necesario reiniciar. Este es el método recomendado si tu Windows ofrece wsl --install. (Si te sale un listado de opciones en lugar de instalar, asegúrate de ejecutar el terminal como administrador y de que Windows está actualizado). Documentación oficial de instalación.

Instalación manual (si wsl --install falla) — comandos DISM/PowerShell

Si el comando único no funciona (ediciones antiguas, políticas de empresa o tiendas bloqueadas), sigue estos pasos manuales en PowerShell con privilegios de administrador:

1. Habilita los componentes:

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -NoRestart

Alternativa con DISM:

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

2. Reinicia el equipo.
3. Instala el paquete del kernel de WSL si el sistema lo solicita (en instalaciones manuales puede requerirse el instalador MSI del kernel).
4. Instala la distribución desde Microsoft Store o importando manualmente una imagen (.appx/.wsl) y luego ejecútala para configurar el usuario.

Si tu entorno bloquea Microsoft Store, puedes usar wsl --import para añadir una distribución desde un archivo tar/ .wsl.

Instalar una distribución y primer arranque

Si usaste wsl --install -d Ubuntu la distribución se instalará y en el primer arranque te pedirá crear un usuario y contraseña. Si instalaste desde la Microsoft Store, busca la distribución (Ubuntu, Debian, Fedora, etc.), instálala y ábrela.

Asegurar que la versión por defecto es WSL2

Para forzar que las nuevas distribuciones utilicen WSL2 ejecuta:

wsl --set-default-version 2

Si ya tienes una distribución instalada y quieres convertirla a WSL2:

wsl --set-version <NombreDistro> 2

Estos comandos requieren que la característica Virtual Machine Platform esté habilitada y que la virtualización en firmware esté activa.

Actualizar el kernel de WSL y comprobar estado

Para actualizar el kernel gestionado por WSL y comprobar estado:

wsl --update
wsl --update --check
wsl --status

Si no puedes usar Microsoft Store para las actualizaciones, existe la opción de descarga web del paquete de servicio del kernel en entornos corporativos (ver ayuda de actualización).

Comprobar la instalación: comandos útiles

• wsl -l -v — lista distribuciones y su versión (WSL1 o WSL2).
• wsl --status — estado general e información del kernel.
• wsl --shutdown — apaga todas las instancias WSL (útil antes de cambiar configuración o exportar importes).

Problemas comunes y soluciones rápidas

• Mensaje: «Please enable the Virtual Machine Platform…»
  Solución: habilita la característica Virtual Machine Platform (ver comandos DISM/PowerShell), reinicia y confirma que la virtualización está activa en BIOS/UEFI.
• Error al ejecutar wsl --install sin efecto
  Comprueba que ejecutas PowerShell como administrador y que Windows está actualizado; si tu organización bloquea Store, usa la instalación manual e importa la distro.
• Virtualización reportada como desactivada pero activada en BIOS
  Revisa en Task Manager > Performance y en systeminfo la línea «Hyper-V Requirements». En algunos equipos OEM hay ajustes de seguridad que bloquean VT; actualiza firmware/BIOS o consulta al fabricante.
• Conflictos con VirtualBox/VMware
  Versiones antiguas de VirtualBox pueden requerir desactivar Hyper-V/Windows features; actualiza VirtualBox a versiones que soporten Hyper-V o usa la opción de compatibilidad en el hipervisor de terceros.

Consejos post-instalación

• Si vas a usar contenedores, usa Docker sobre WSL2 (mejor rendimiento que Hyper-V) — guía relacionada: Docker en Windows con WSL: Guía Completa.
• Para desarrollo con VS Code, instala la extensión Remote – WSL para editar dentro de la distro de forma nativa.
• No almacenes proyectos intensivos en I/O en la ruta /mnt/c/… si buscas máximo rendimiento; usa el sistema de ficheros de la propia distribución o sigue buenas prácticas de almacenamiento.
• Si necesitas Docker Desktop con integración WSL, consulta la guía de instalación específica: Instalación Docker Desktop en Windows.

Seguridad y buenas prácticas

• Mantén Windows y las distribuciones actualizadas (usar wsl --update y las propias herramientas de la distro).
• Usa cuentas de usuario separadas en la distro para tareas administrativas y evita ejecutar servicios expuestos sin cortafuegos.
• Realiza backups de datos importantes antes de operaciones de conversión o exportación de distros (wsl --export / wsl --import).

Resumen rápido — comandos clave

wsl --install                 # método rápido (recomendado)
wsl --install -d Ubuntu        # instalar Ubuntu
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -NoRestart
wsl --set-default-version 2
wsl -l -v
wsl --update
wsl --status
wsl --shutdown

Preguntas frecuentes (FAQ)

¿Necesito Hyper-V para WSL2? No es necesario usar la funcionalidad Hyper-V completa; WSL2 requiere la característica Virtual Machine Platform. En Windows 11 Home no necesitas Hyper-V tradicional, pero sí Virtual Machine Platform y virtualización firmware.

Mi equipo está virtualizado (VM), ¿puedo usar WSL2? Solo si el host tiene habilitada la nested virtualization y la VM permite exponer las extensiones VT-x/AMD-V. En entornos gestionados puede que esté bloqueado.

¿Puedo volver a WSL1? Sí, conviertes una distro con wsl --set-version <Distro> 1, pero WSL1 tiene limitaciones frente a WSL2 (compatibilidad binaria y rendimiento distinto).

Si quieres, puedo ofrecerte un checklist personalizado según tu versión exacta de Windows (escríbeme el resultado de winver y systeminfo | findstr /C:"Virtualization Enabled In Firmware" y te indico los pasos concretos).