WSL

Instalar WSL en Windows 11: requisitos, comando único y errores frecuentes

noviembre 8, 2026 Window Error 14 min read
Instalar WSL en Windows 11: requisitos, comando único y errores frecuentes

Quien busca "instalar wsl windows 11" quiere poner en marcha el Subsistema de Windows para Linux desde cero o después de un fallo, en su PC con Windows 11. Lo más probable es que baste con abrir Terminal como administrador y ejecutar wsl --install, reiniciar y crear una cuenta de Ubuntu la primera vez que se abra. Si la instalación se atasca al 0,0 % o sale el error 0x80370102 al abrir la distro, la causa casi siempre está en la virtualización desactivada o en la característica Plataforma de máquina virtual. Esta guía cubre Windows 11 en todas sus ediciones actuales.

Qué es WSL y qué consigues al instalarlo en Windows 11

El Subsistema de Windows para Linux (WSL) es la capa de Windows que permite ejecutar un Linux real dentro del propio sistema, sin máquina virtual ni arranque dual. Con WSL puedes abrir una Terminal con bash, instalar paquetes con apt, levantar servidores de pruebas o usar herramientas que solo existen en Linux, todo desde la misma sesión de Windows 11. Para quien viene de macOS o Linux, es el equivalente a tener una shell nativa; para quien nunca lo ha tocado, es una forma segura de practicar sin arriesgar el sistema principal.

Para ponerlo en marcha hace falta un único comando, wsl --install, escrito en PowerShell o Terminal como administrador. Ese comando habilita por sí solo las funciones internas que WSL necesita, baja el kernel de Linux y deja instalada una distribución: Ubuntu en las instalaciones nuevas. WSL 2 es la arquitectura que se usa por defecto: corre un kernel Linux real dentro de Windows, con mejor rendimiento y compatibilidad que WSL 1, y por eso es la opción que Microsoft recomienda desde hace tiempo.

Lo que falla al instalar WSL en Windows 11 y por qué

Lo que ves Causa probable Dónde se arregla
El progreso de instalación se queda al 0,0 % y no avanza El certificado de la tienda o el canal interno de descarga está bloqueado La instalación de WSL se queda al 0,0 % en Windows 11
Al abrir la distro aparece 0x80370102 No se pudo iniciar la máquina virtual porque no está instalada una característica requerida Falta Plataforma de máquina virtual, la virtualización está apagada en la UEFI o el hipervisor no se carga 0x80370102 al abrir la distribución de WSL en Windows 11
La distro nueva no aparece en el menú Inicio o wsl --list --verbose no la lista Se ejecutó el comando desde la cuenta Administrator integrada de Windows La distro nueva no aparece en Inicio o wsl no la reconoce
WSL falla o se atasca sin un mensaje claro Componentes dañados, mezcla de WSL 1 y 2 o distro corrupta Otros problemas típicos de WSL en Windows 11 y cómo salirse

Comprueba si tu Windows 11 está listo para WSL

Antes de tocar nada, conviene confirmar tres cosas: que Windows 11 está razonablemente actualizado, que la compilación es la mínima y que la virtualización del procesador está encendida. WSL 2 necesita Windows 10 versión 2004 (compilación 19041) o superior, y todas las versiones de Windows 11 lo cumplen de sobra, así que un Windows 11 actualizado rara vez se queda fuera por esto.

  1. Pulsa Win+R, escribe winver y pulsa Enter. Aparece una ventana con la versión y la compilación de Windows 11. Cualquiera de las ediciones actuales (24H2, 25H2, 26H1 o 26H2) vale.
  2. Abre Configuración > Windows Update > Historial de actualizaciones y comprueba que no haya una actualización pendiente con errores. Si Windows está pidiendo reiniciar, hazlo antes de seguir.
  3. Abre el Administrador de tareas con Ctrl+Mayús+Esc, ve a la pestaña Rendimiento, pulsa CPU y mira abajo, donde pone Virtualización. Tiene que decir Enabled. Si dice Disabled, lo arreglas en la BIOS/UEFI.

Windows 10 como entorno para WSL

Nota: Windows 10 22H2 dejó de tener soporte el 14 de octubre de 2025. Los particulares solo pueden seguir recibiendo parches de seguridad pagando el programa ESU hasta el 13 de octubre de 2026. En Windows 10 el comando wsl --install funciona igual en la versión 2004 y posteriores, así que esta guía también sirve si todavía estás en Windows 10, salvo porque el camino de Hyper-V/Plataforma de máquina virtual en Home es el mismo.

Instalar WSL en Windows 11 con el comando único

Este es el caso normal: Windows 11 actualizado y la virtualización activa. El propio comando se encarga de activar lo que falta.

Activa "Plataforma de máquina virtual" en características de Windows

Antes de instalar WSL, conviene asegurarse de que la función Plataforma de máquina virtual está habilitada. Es lo que permite que el hipervisor arranque y que WSL 2 funcione. En Windows 11 Home existe y se activa sin problemas; Hyper-V completo sí es de Pro y superiores, pero para WSL no hace falta.

Panel de controlProgramasProgramas y característicasActivar o desactivar las características de Windows
  1. Pulsa Win+R, escribe optionalfeatures y pulsa Enter.
  2. Marca Plataforma de máquina virtual y Plataforma del hipervisor de Windows. Pulsa Aceptar.
  3. Reinicia cuando te lo pida.
Comprueba: Al volver a optionalfeatures, las dos casillas siguen marcadas y Windows arranca sin mensaje de error.

Ejecuta wsl –install y reinicia

Una vez habilitadas las funciones, el comando único hace el resto: baja el kernel de Linux, instala Ubuntu y deja WSL 2 como versión por defecto.

  1. Clic derecho en el botón Inicio y elige Terminal (Administrador). Confirma el cuadro de Control de cuentas de usuario.
  2. Escribe wsl --install y pulsa Enter. Verás cómo aparecen los pasos de habilitación de componentes, descarga del kernel e instalación de Ubuntu.
  3. Cuando termine, reinicia el PC desde Win+X > Apagar o cerrar sesión > Reiniciar.
  4. Tras reiniciar, abre Ubuntu desde Inicio, espera a que termine la configuración inicial y crea tu usuario y contraseña de Linux cuando te los pida.
Comprueba: Abre Terminal (sin administrador) y ejecuta wsl --list --verbose. Debe listar Ubuntu con la columna VERSION en 2 y la columna STATE en Running o Stopped.

Elige otra distribución o cámbiala luego

Si prefieres otra distro, o quieres cambiar la que ya tienes, no hace falta desinstalar nada: el comando wsl --install acepta el parámetro -d. Las distribuciones soportadas por Microsoft en sus repositorios oficiales son Ubuntu, OpenSUSE, Kali, Debian y Arch Linux.

  1. En Terminal como administrador, ejecuta wsl --list --online para ver la lista actualizada de distribuciones disponibles.
  2. Instala la que quieras con wsl --install -d Debian (cambia Debian por la distro).
  3. Para fijar la versión de una distro ya instalada, usa wsl --set-version Ubuntu 2. Para volver a WSL 1, cambia el 2 por 1; por ejemplo, wsl --set-version Ubuntu 1.
  4. Para abrirla desde la Terminal de Windows o desde PowerShell, basta con escribir wsl o el nombre de la distro, como ubuntu, debian o kali.
Comprueba: wsl --list --verbose muestra la distro nueva con VERSION en 2. Si abres la Terminal de Windows (recomendada frente a la consola clásica), cada distro puede correr en una pestaña aparte.

La instalación de WSL se queda al 0,0 % en Windows 11

Cuando el progreso de la barra no avanza y la instalación se queda clavada en 0,0 %, casi siempre es un problema de canal de descarga: la opción por defecto usa componentes internos de Microsoft Store y se atasca si algún proxy o política los está bloqueando. La solución es forzar la descarga del MSI manual.

Cuidado: Si la instalación lleva muchas horas al 0,0 %, no la canceles a lo bruto cerrando la Terminal de golpe: deja que Ctrl+C la aborte limpio, espera al menos un minuto y vuelve a probar.

Prueba la descarga alternativa con –web-download

  1. Abre Terminal como administrador.
  2. Ejecuta wsl --install --web-download -d Ubuntu. El parámetro --web-download fuerza a bajar el instalador MSI desde la web en lugar de usar el canal AppX interno, y suele esquivar el bloqueo.
  3. Cuando termine, reinicia y abre Ubuntu desde Inicio para crear tu cuenta.
Comprueba: La barra avanza más allá del 0,0 % y Ubuntu abre para pedirte usuario y contraseña.

Reinstala el kernel de WSL o descarga el MSI manual

Si aún así se atasca, queda actualizar o reinstalar el kernel a mano desde el repositorio oficial.

  1. En Terminal como administrador, ejecuta wsl --update. Mira a ver si descarga e instala algo.
  2. Si no, descarga el MSI manual desde https://github.com/microsoft/wsl/releases y ejecuta el archivo .msi para reinstalar el kernel.
  3. Vuelve a wsl --install -d Ubuntu para terminar la instalación de la distro.
Comprueba: wsl --status muestra la versión del kernel instalada y wsl --list --verbose lista Ubuntu.

0x80370102 al abrir la distribución de WSL en Windows 11

El error 0x80370102 No se pudo iniciar la máquina virtual porque no está instalada una característica requerida significa exactamente eso: al componente que arranca el hipervisor le falta algo. Las tres causas, de más frecuente a menos, son: Plataforma de máquina virtual desactivada, virtualización apagada en la UEFI o hipervisor que no carga por orden de arranque (hypervisorlaunchtype Off).

Activa la virtualización en la UEFI del equipo

Si en el Administrador de tareas la virtualización salía Disabled, hay que encenderla en la BIOS/UEFI. La tecla para entrar depende del fabricante del PC o de la placa, por lo que conviene consultar la web de soporte de HP, Lenovo, Dell, Asus o del fabricante correspondiente antes de buscar a ciegas.

  1. Reinicia el PC y entra a la BIOS/UEFI pulsando la tecla que indique tu fabricante (consulta su web de soporte; no hay una tecla universal).
  2. Busca las opciones del procesador, normalmente en un apartado llamado Advanced, CPU Configuration o Security.
  3. Activa Intel Virtualization Technology (Intel VT-x) o SVM Mode (en AMD). Guarda y reinicia.
  4. Vuelve a abrir el Administrador de tareas > Rendimiento > CPU y comprueba que ahora pone Virtualization: Enabled.
Comprueba: En el Administrador de tareas la virtualización ya dice Enabled. Si al abrir Ubuntu sigue saliendo 0x80370102, pasa al siguiente H3.

Habilita el hipervisor y "Plataforma de máquina virtual"

Si la virtualización está encendida pero Windows no carga el hipervisor, hay que forzar el arranque del hipervisor y revisar la característica de Windows.

  1. Abre Terminal como administrador.
  2. Comprueba el estado con bcdedit /enum | findstr -i hypervisorlaunchtype. Si la respuesta es hypervisorlaunchtype Off, el hipervisor está desactivado por arranque.
  3. Activa el arranque automático con bcdedit /set hypervisorlaunchtype Auto y reinicia.
  4. Asegúrate también de que Plataforma de máquina virtual y Plataforma del hipervisor de Windows están marcadas en optionalfeatures (revisado en el paso anterior).
  5. Abre Ubuntu de nuevo.
Comprueba: Ubuntu abre sin 0x80370102 y wsl --list --verbose muestra STATE: Running.

La distro nueva no aparece en Inicio o wsl no la reconoce

Hay un caso particular que confunde: si abriste PowerShell o Terminal desde la cuenta Administrator integrada de Windows (la que se crea al instalar y se queda oculta), WSL se instala pero no muestra la distro en wsl --list --verbose, y el acceso directo en Inicio no aparece. Es una limitación conocida de la cuenta integrada, no un fallo del sistema.

No la ejecutes con la cuenta Administrator integrada

  1. Cierra la sesión actual y entra con una cuenta estándar: una cuenta local o tu cuenta Microsoft personal.
  2. Abre Terminal como administrador desde esa cuenta.
  3. Ejecuta wsl --list --verbose y comprueba que Ubuntu ya aparece listada con VERSION 2.
  4. Búscala también en Inicio, donde debería estar su icono.
Comprueba: Ubuntu aparece en Inicio y wsl --list --verbose la lista. Si la abres, llega al prompt de Linux sin errores.

Otros problemas típicos de WSL en Windows 11 y cómo salirse

Cuando WSL falla sin un mensaje claro, se atasca al arrancar una distro o se queda en estado Installing para siempre, lo más eficaz es reparar la app, reinstalar la distro y, en último caso, desactivar WSL por completo y volver a activarlo desde cero.

Restablecer la aplicación de Linux desde Configuración

ConfiguraciónAplicacionesAplicaciones instaladas
  1. Abre Configuración > Aplicaciones > Aplicaciones instaladas y busca Ubuntu (o el nombre de tu distro).
  2. Pulsa los tres puntos y elige Opciones avanzadas.
  3. Baja hasta Restablecer y pulsa el botón. Windows la deja como recién instalada.
  4. Si sigue fallando, repite con Reparar (lo hace primero, es menos agresivo).
  5. Reinstala la distro desde Terminal como administrador con wsl --install -d Ubuntu.
Comprueba: La distro abre y wsl --list --verbose la marca como Running o Stopped sin errores.

Desinstalar WSL y reinstalar desde cero

Si nada de lo anterior funciona, queda la opción nuclear: quitar la distro, desactivar las funciones de Windows y volver a empezar.

Cuidado: wsl --unregister borra la distribución, incluidos los archivos del usuario Linux dentro de ella. Antes de hacerlo, copia a Windows (\wsl$\<Distro>\home\<usuario>) lo que quieras conservar y crea un punto de restauración desde Configuración > Sistema > Recuperación > Restaurar sistema > Abrir Restaurar sistema > Crear un punto.
  1. Desinstala la distro con wsl --unregister Ubuntu.
  2. Abre optionalfeatures y desmarca Plataforma de máquina virtual y Plataforma del hipervisor de Windows. Acepta y reinicia.
  3. Tras reiniciar, vuelve a marcar las dos casillas en optionalfeatures y reinicia otra vez.
  4. Abre Terminal como administrador y ejecuta wsl --install -d Ubuntu. Configura usuario y contraseña la primera vez.
Comprueba: Ubuntu abre limpia y wsl --status muestra WSL 2 como versión predeterminada.

Lo que WSL necesita de tu PC y dónde mirarlo

  • Windows 11 actualizado en 24H2, 25H2, 26H1 o 26H2; también Windows 10 a partir de la versión 2004 (compilación 19041).
  • Virtualización del procesador activa en la UEFI (Intel VT-x o AMD SVM).
  • Funciones Plataforma de máquina virtual y Plataforma del hipervisor de Windows habilitadas en optionalfeatures.
  • Un único comando en Terminal como administrador: wsl --install.
  • WSL 2 como arquitectura por defecto en las instalaciones nuevas.

Datos comprobados en octubre de 2026. Para profundizar, la documentación oficial está en learn.microsoft.com/es-es/windows/wsl/install. Si quieres más comandos o solución de errores avanzada, la sección de solución de problemas de WSL en inglés tiene el detalle.

Dudas sobre instalar WSL en Windows 11

  • ¿Qué es WSL en Windows 11 y para qué sirve?
  • ¿Cómo activar el Subsistema de Windows para Linux paso a paso?
  • ¿Por qué la instalación de WSL se queda al 0,0 %?
  • ¿Cómo arreglar el error 0x80370102 al abrir Ubuntu?
  • ¿Cómo instalar otra distribución de Linux en WSL?
  • ¿Cómo desinstalar WSL y reinstalarlo desde cero?

Dudas sobre instalar WSL en Windows 11

1. ¿Cómo instalar WSL en Windows 11?

Abre la Terminal o el Símbolo del sistema como administrador (clic derecho en Inicio) y escribe wsl –install. Reinicia cuando te lo pida y, la primera vez que abras Ubuntu, crea el usuario y la contraseña que te solicita. En unos minutos ya tendrás WSL con Ubuntu como distribución por defecto.

2. ¿Y si quiero instalar WSL en Windows 10?

En Windows 10 necesitas tener la versión 1909 o posterior con KB4566116 aplicado; desde ahí el comando es el mismo, wsl –install ejecutado en PowerShell como administrador. Si el comando no existe, puedes activar la característica «Subsistema de Windows para Linux» desde «Panel de control > Programas > Activar características de Windows» y reiniciar.

3. ¿Qué cambia en WSL 2 respecto a WSL 1 en Windows 11?

WSL 2 corre un kernel Linux real dentro de una máquina virtual ligera, así que el rendimiento en disco es mucho mejor y la compatibilidad con aplicaciones es total. Para pasarte, ejecuta wsl –set-version Ubuntu 2 desde PowerShell; el cambio tarda unos minutos y puedes volver a la versión 1 con el mismo comando cambiando el 2 por un 1.

4. ¿Cómo desinstalo WSL en Windows 11?

Si solo quieres quitar una distribución, ejecuta wsl –unregister NombreDistribucion en PowerShell. Para desactivar WSL por completo, abre «Activar o desactivar características de Windows», desmarca «Subsistema de Windows para Linux» y «Plataforma de máquina virtual», y reinicia el equipo.

5. ¿Cómo abro WSL una vez instalado?

Desde Inicio busca «Ubuntu» (o la distribución que hayas instalado) y ábrela, o escribe wsl en Terminal o en Ejecutar (Win+R). Tu carpeta personal de Linux está en \wsl$\Ubuntu\home\ desde el Explorador de archivos de Windows.

6. ¿WSL funciona en Windows 10?

Sí, desde la versión 1909 con la actualización KB4566116 ya puedes usar el comando wsl –install; antes había que habilitar las características manualmente. Ten en cuenta que Home y Pro lo soportan igual, y que para WSL 2 hace falta activar también «Plataforma de máquina virtual».

7. ¿Cómo instalo Ubuntu en WSL en Windows 11?

Tras el wsl –install y el reinicio, Ubuntu se instala como distribución por defecto y solo tienes que abrirla desde Inicio la primera vez para crear usuario y contraseña. Si prefieres otra versión (por ejemplo 22.04), instálala desde la Microsoft Store y luego elige wsl –set-default Ubuntu-22.04.

8. ¿Dónde descargo WSL para Windows 11?

No hay un «instalador» aparte: WSL viene con el propio Windows 11 y se activa con wsl –install desde PowerShell como administrador. La aplicación de cada distribución (Ubuntu, Debian, Kali, etc.) se descarga gratis desde la Microsoft Store, y todas las tiendas alternativas o DLL sueltas son de dudosa fiabilidad.

Fuentes

  1. MicrosoftManual installation steps for older versions of WSL – Microsoft Learnconsultado el 16/10/2026
  2. MicrosoftSubsistema de Windows para Linux (WSL) — documentación oficialconsultado el 16/10/2026
  3. MicrosoftErrores de WSL, Hyper-V y la virtualización (0x80370102 y «virtualización deshabilitada») — documentación oficialconsultado el 16/10/2026