Subsistema de Windows para Linux: qué es y errores más habituales al instalarlo

Quien busca «subsistema de Windows para Linux» suele querer instalarlo o arreglar un error al abrir la distribución. En este artículo se entiende por WSL: la capa de Microsoft que ejecuta Linux dentro de Windows, con wsl --install y, en la mayoría de los casos, WSL 2. Lo primero que conviene probar es wsl --install en una Terminal como administrador y reiniciar. Aplica a Windows 10 versión 2004 o superior y a Windows 11.

Qué es el Subsistema de Windows para Linux y qué hace en tu PC

WSL es una capa de Microsoft que permite ejecutar un entorno Linux dentro de Windows, sin máquina virtual ni arranque dual. Hoy, con WSL 2, corre un kernel Linux real dentro de una máquina virtual ligera gestionada por Windows, y permite abrir distribuciones como Ubuntu, Debian, Kali, openSUSE o Arch Linux desde el menú Inicio o desde la Terminal. Desde ellas se usan sus comandos (bash, grep, vim, tmux) y sus lenguajes (Python, Node.js, Rust, Go) y, además, se pueden lanzar aplicaciones gráficas Linux integradas en el escritorio de Windows.

Por qué WSL no se instala o no arranca: lo que puede estar fallando

Comprueba qué bloquea WSL antes de tocar nada

Antes de cambiar ajustes, conviene confirmar tres cosas: la versión de Windows, que las dos características de WSL estén marcadas y que el hipervisor arranque. Con esto sabrás si el problema es de sistema, de características desactivadas o de virtualización, y podrás ir directo a la parte que te toca.

La versión y la edición de Windows

WSL pide Windows 10 versión 2004 o superior, o Windows 11. Para comprobarlo:

1. Pulsa Win+R, escribe winver y pulsa Enter.
2. Anota la versión (por ejemplo, 22H2) y la compilación.
3. En Configuración > Sistema > Acerca de, comprueba también la edición (Home o Pro).

Las características de Windows que necesita WSL

Las dos características obligatorias son «Subsistema de Windows para Linux» y «Plataforma de máquina virtual». Para revisarlas:

1. Pulsa Win+R, escribe optionalfeatures y pulsa Enter.
2. Comprueba que están marcadas «Subsistema de Windows para Linux» y «Plataforma de máquina virtual».
3. Si falta alguna, márcala, pulsa Aceptar y reinicia cuando te lo pida.

El estado del hipervisor y la virtualización

El hipervisor de Windows tiene que estar en Auto; si está en Off, las distros en WSL 2 no arrancan. Para comprobarlo, abre Terminal como administrador (clic derecho en el botón Inicio > Terminal (Administrador) en Windows 11; en Windows 10, Windows PowerShell (Administrador)) y ejecuta:

bcdedit /enum | findstr -i hypervisorlaunchtype

hypervisorlaunchtype    Auto

Si la línea dice Auto, el hipervisor carga al arrancar. Si dice Off, hay que forzarlo (más adelante). Si no aparece ninguna línea, el comando se ejecutó sin permisos de administrador.

wsl --install falla o no aparece ninguna distribución

Le pasa a quien ejecuta wsl --install en PowerShell y, tras reiniciar, no ve Ubuntu en el menú Inicio o la Store no descarga nada. La causa más frecuente es que la característica no se activó o que falta «Plataforma de máquina virtual».

Activa WSL y la Plataforma de máquina virtual a mano

Activar las dos características a mano deja Windows en el mismo estado que wsl --install, pero te asegura que se aplican aunque la Store falle. Abre Terminal como administrador y ejecuta, en este orden:

DISM /Online /Enable-Feature /FeatureName:Microsoft-Windows-Subsystem-Linux /All /Norestart
DISM /Online /Enable-Feature /FeatureName:VirtualMachinePlatform /All /Norestart

1. Pulsa Win+X y elige Terminal (Administrador) o PowerShell (Administrador).
2. Escribe los dos comandos de arriba, uno por uno, y espera a que cada uno termine.
3. Reinicia el equipo.
4. Al volver, abre de nuevo Terminal como administrador y ejecuta wsl --install para que se descargue la distribución por defecto (Ubuntu).

Instala Ubuntu desde Microsoft Store si wsl --install no la descarga

A veces wsl --install se ejecuta bien pero la Store no descarga la distro, sobre todo en equipos con poco espacio o con la Store desactualizada. La alternativa es instalarla a mano:

1. Abre Microsoft Store, busca «Ubuntu» y pulsa Instalar.
2. Cuando termine, abre Ubuntu desde el menú Inicio.
3. La primera vez te pedirá un nombre de usuario y una contraseña para Linux: créalos.
4. Cierra Ubuntu y, en Terminal, ejecuta wsl -l -v para confirmar la distribución y la versión (1 o 2).

0x80370102 al abrir la distribución: la virtualización está apagada

Este error significa que Windows no puede levantar la máquina virtual ligera en la que corre WSL 2. Suele pasar por la virtualización desactivada en la UEFI o por el hipervisor en Off. La distro, al abrir, muestra un mensaje con el código.

Enciende Intel VT-x o AMD SVM en la UEFI

La virtualización del procesador (Intel VT-x o AMD SVM) tiene que estar activa; si está apagada, ni WSL 2 ni Hyper-V pueden arrancar. Se enciende en la BIOS o UEFI de la placa.

1. Apaga el PC y vuelve a encenderlo.
2. Entra en la BIOS/UEFI pulsando la tecla que indique tu fabricante (suele ser Supr, F2 o F10; en portátiles Lenovo es F2 o F1; en HP, F10 o Esc).
3. Busca el apartado «Advanced», «CPU Configuration» u «OC» y entra en las opciones del procesador.
4. Activa «Intel Virtualization Technology» o «SVM Mode» (puede llamarse «AMD-V»).
5. Guarda los cambios y reinicia.

Fuerza el arranque del hipervisor

Si la virtualización está activa en la UEFI pero bcdedit /enum sigue diciendo Off, fuerza el hipervisor a Auto. Abre Terminal como administrador y ejecuta:

bcdedit /set hypervisorlaunchtype Auto

1. Pulsa Win+X y abre Terminal (Administrador) o PowerShell (Administrador).
2. Escribe el comando y pulsa Enter.
3. Reinicia el equipo.
4. Al volver, ejecuta otra vez bcdedit /enum | findstr -i hypervisorlaunchtype para confirmar que ahora dice Auto.

VMware o VirtualBox dejan de funcionar tras instalar WSL 2

Le pasa a quien instala WSL 2 y, al abrir una máquina virtual de VMware o VirtualBox, recibe un error de «hypervisor» o la máquina no arranca. La causa es que WSL 2 usa el hipervisor de Windows (Hyper-V) y las versiones viejas de esos programas no conviven con él. Hay dos salidas: usar WSL 1 en la distro o actualizar el hipervisor.

Pasa la distro a WSL 1

WSL 1 no usa Hyper-V y por eso no entra en conflicto con VMware o VirtualBox. El rendimiento del sistema de archivos entre Windows y Linux es peor, pero el sistema vuelve a funcionar. En Terminal:

wsl --set-version Ubuntu 1

1. Ejecuta wsl -l -v para ver el nombre exacto de la distro y la versión actual.
2. Sustituye Ubuntu por el nombre que aparece en la columna NAME.
3. Ejecuta wsl --set-version <Nombre> 1 y espera a que termine la conversión.
4. Vuelve a wsl -l -v para confirmar que la versión es 1.

Actualiza VMware a 15.5.5+ o VirtualBox a 6+

Las versiones modernas de estos hipervisoresconviven con Hyper-V y con WSL 2. VMware Workstation Pro/Player 15.5.5 o superior y VirtualBox 6 o superior traen el modo «hypervisor aware». Para actualizar:

1. Descarga la última versión estable desde la web oficial: vmware.com o virtualbox.org.
2. Instala encima de la versión actual; los ajustes y las máquinas se conservan.
3. Reinicia y vuelve a abrir la máquina virtual.

La distribución abre pero falla o va lenta

Le pasa a quien abre Ubuntu (u otra distro) y ve errores al instalar paquetes, comandos que no se encuentran o una lentitud notable al entrar en carpetas del disco de Windows. La causa suele ser la distro en WSL 1 cuando toca WSL 2, o la instalación de la distro dañada por una actualización grande de Windows.

Repara la distro desde Aplicaciones instaladas

Windows trae una opción para reparar la distro sin desinstalarla, que reinstala sus archivos internos. Para usarla:

1. Abre Configuración (Win+I) y ve a Aplicaciones > Aplicaciones instaladas.
2. Busca la distro (Ubuntu, Debian, Kali…) en la lista y pulsa los tres puntos > Opciones avanzadas.
3. Baja hasta «Restablecer» y, primero, pulsa Reparar.
4. Si sigue fallando, vuelve al mismo sitio y pulsa Restablecer: esto borra los archivos de la distro, pero deja Windows como está.

Convierte la distro a WSL 2 desde la Terminal

Una distro en WSL 1 va más lenta al tocar archivos en /mnt/c y no soporta las apps GUI. La conversión se hace en caliente, sin reinstalar. En Terminal:

wsl --set-version Ubuntu 2

1. Ejecuta wsl -l -v para ver la versión actual.
2. Si la versión es 1, ejecuta wsl --set-version <Nombre> 2 con el nombre exacto de la distro.
3. Espera a que termine (puede tardar varios minutos).
4. Si da error, desinstala la distro desde Configuración > Aplicaciones > Aplicaciones instaladas y vuelve a instalarla desde Microsoft Store, que la deja en WSL 2 por defecto.

Si nada de esto funciona, vuelve a un estado conocido

Cuando wsl --install falla, la distro no arranca y la BIOS ya está bien, el problema suele ser un estado roto de las características de Windows o un kernel de WSL 2 desactualizado. Antes de reinstalar Windows, prueba estos dos recursos.

Quita y vuelve a activar las características de WSL

Desactivar y reactivar las dos características las deja como recién instaladas y, en muchos casos, resuelve fallos que vienen de actualizaciones de Windows a medias. Abre Terminal como administrador y ejecuta:

DISM /Online /Disable-Feature /FeatureName:Microsoft-Windows-Subsystem-Linux /Norestart
DISM /Online /Disable-Feature /FeatureName:VirtualMachinePlatform /Norestart

1. Escribe los dos comandos, espera a que terminen y reinicia.
2. Al volver, abre Terminal como administrador y ejecuta wsl --install.
3. Si prefieres hacerlo a mano, vuelve a usar los dos DISM /Online /Enable-Feature ... del principio y reinicia.

Actualiza Windows y el paquete del kernel de WSL 2

Microsoft publica el kernel de WSL 2 como una actualización de «otros productos de Microsoft», no como actualización opcional de controladores, y eso hace que muchos lectores ni la vean. Para forzar la actualización:

1. Abre Configuración (Win+I) y ve a Windows Update > Buscar actualizaciones.
2. Si hay algo pendiente, instálalo y reinicia.
3. Vuelve a Windows Update > Opciones avanzadas y comprueba que «Recibir actualizaciones de otros productos de Microsoft» está activado.
4. Pulsa Buscar actualizaciones otra vez: el kernel de WSL 2 aparecerá como «Actualización del kernel del Subsistema de Windows para Linux».
5. Instálalo y reinicia.

Lo que ya tienes claro sobre el Subsistema de Windows para Linux

• WSL corre Linux dentro de Windows, con kernel real (WSL 2) y sin máquina virtual externa.
• Necesita Windows 10 versión 2004 o superior, o Windows 11, y la virtualización activa en la UEFI.
• Las dos características obligatorias son «Subsistema de Windows para Linux» y «Plataforma de máquina virtual».
• El hipervisor de Windows debe estar en Auto (bcdedit /set hypervisorlaunchtype Auto).
• El error 0x80370102 casi siempre es virtualización apagada o hipervisor en Off.
• Hyper-V completo no está en Home; WSL 2 sí.
• VMware o VirtualBox necesitan la versión 15.5.5+ o 6+ para convivir con WSL 2.
• El siguiente paso, si todo falla, es reinstalar la distro desde Microsoft Store o, como último recurso, restablecer Windows.

Datos comprobados en octubre de 2026.

Dudas sobre el Subsistema de Windows para Linux y sus errores