Cómo instalar y configurar el Subsistema de Windows para Linux 2 (WSL2)

Si desarrollas en Windows pero necesitas el ecosistema de Linux, el Subsistema de Windows para Linux 2 (WSL2) es probablemente una de las mejores herramientas que puedes instalar en tu equipo. Te permite tener una distro GNU/Linux real integrada en Windows, con su terminal, sus paquetes y hasta aplicaciones gráficas, sin pelearte con máquinas virtuales pesadas ni configuraciones de arranque dual.

En esta guía vamos a ver cómo instalar y configurar WSL2 paso a paso en Windows 10 y Windows 11, qué requisitos necesitas, cómo elegir tu distribución favorita (Ubuntu, Debian, Kali, Fedora, etc.), cómo comprobar qué versión de WSL estás usando, cómo actualizar de WSL1 a WSL2, cómo gestionar varias distros a la vez y qué buenas prácticas conviene seguir para sacarle todo el jugo en entornos de desarrollo y empresa.

¿Qué es WSL2 y por qué merece la pena usarlo?

El Subsistema de Windows para Linux, o WSL, es una característica de Windows que permite ejecutar un entorno Linux completo dentro de Windows sin depender de una máquina virtual tradicional ni de un arranque dual. La versión WSL2 utiliza un kernel de Linux real ejecutándose en una máquina virtual ligera gracias a la plataforma de virtualización de Windows (Hyper-V y Virtual Machine Platform).

Requisitos previos para instalar WSL2

Antes de lanzarte a instalar nada conviene asegurarse de que tu sistema cumple los requisitos mínimos de Windows. Para usar los comandos modernos de WSL en modo simplificado necesitas:

Windows 10 versión 2004 o posterior (compilación 19041 o superior) o
Windows 11 en cualquiera de sus ediciones compatibles.

Si tienes Windows 10 pero con una build anterior a 19041, puedes seguir usando WSL, pero tendrás que recurrir al proceso de instalación manual habilitando características y descargando el kernel a mano.

En versiones incluso anteriores, o en algunos Windows Server o ediciones LTSC, puede no funcionar el comando simplificado wsl –install y tendrás que seguir la instalación por pasos. En cualquier caso, comprueba tu versión pulsando Windows + R, escribiendo winver y revisando la ventana que aparece.

Además, en Windows 10 necesitas que el sistema sea de 64 bits y build 18362 o superior para poder trabajar con WSL2 con garantías. Si tienes un Windows de 32 bits no podrás usar WSL y tendrás que optar por alternativas como Git Bash o una virtualización clásica.

Método rápido: instalar WSL2 con un solo comando

En Windows 10 reciente y en Windows 11 dispones de un comando que automatiza todo el proceso de instalación de WSL (características de Windows, kernel y distro por defecto) sin que tengas que ir marcando casillas a mano.

Los pasos básicos son:

Abrir PowerShell como administrador (Inicio > buscar «PowerShell» > clic derecho > Ejecutar como administrador).
Ejecutar el comando:
wsl --install
Reiniciar el equipo cuando lo pida Windows.

Este comando activará automáticamente las características necesarias para WSL y la Plataforma de máquina virtual, descargará el kernel de Linux y, por defecto, instalará Ubuntu como distribución inicial. Más adelante podrás cambiar de distro sin problema.

La primera vez que arranques la distro recién instalada se mostrará una consola con un mensaje de instalación y la extracción de archivos. Ese proceso puede tardar unos minutos, pero los arranques posteriores suelen ser casi instantáneos.

Instalación manual de WSL y WSL2 paso a paso

Si el comando simplificado no está disponible en tu versión, o prefieres tener un control más fino de cada paso, puedes instalar WSL2 de manera manual. El proceso estándar en Windows 10 y 11 se divide en varios pasos.

Paso 1: activar el Subsistema de Windows para Linux

Primero debes habilitar la característica opcional que permite ejecutar Linux dentro de Windows. Para ello, abre PowerShell como administrador y ejecuta:

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

Este comando instala el componente WSL básico. En este punto, si solo quisieras usar WSL1 podrías reiniciar y pasar directamente a la instalación de una distribución, pero para aprovechar WSL2 es importante seguir con el siguiente paso antes de reiniciar.

Paso 2: habilitar la Plataforma de máquina virtual

WSL2 se apoya en una capa de virtualización ligera, así que es obligatorio activar la característica VirtualMachinePlatform. De nuevo en PowerShell con privilegios de administrador, ejecuta:

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Para que estos cambios se apliquen correctamente, ahora sí es necesario reiniciar el equipo. Sin ese reinicio WSL2 no funcionará de forma adecuada.

Paso 3: instalar o actualizar el kernel de Linux para WSL2

WSL2 utiliza un kernel de Linux específico para Windows, que se distribuye como un paquete independiente. Si no lo tienes instalado o quieres estar a la última, puedes hacerlo de dos formas:

Descargando el MSI de actualización del kernel desde la página oficial de versiones de WSL en GitHub o en la documentación de Microsoft, y ejecutándolo como cualquier instalador.
Usando el propio comando de WSL:
wsl --update
que descarga e instala la última versión del kernel disponible desde Microsoft Store.

Una vez instalado el paquete, ya dispones de un kernel de Linux listo para WSL2 en tu sistema. Esto es imprescindible para que las distros funcionen en modo 2.

Paso 4: establecer WSL2 como versión por defecto

Para que todas las nuevas distribuciones de Linux que instales se configuren directamente con WSL2 en lugar de WSL1, abre PowerShell y ejecuta:

wsl --set-default-version 2

Si obtienes errores en este punto, suele ser indicio de que la actualización del kernel no se ha instalado correctamente o de que no se ha habilitado la Plataforma de máquina virtual. Conviene revisar esos pasos antes de continuar.

Paso 5: instalar una distribución de Linux

Con WSL habilitado y el kernel de WSL2 operativo, puedes instalar la distribución de Linux que prefieras. Tienes varias opciones según tu entorno:

Instalar una distro desde Microsoft Store

El método más cómodo es usar la Microsoft Store:

Abrir Microsoft Store desde el menú Inicio.
Buscar la distribución deseada (por ejemplo, Ubuntu, Debian, Fedora, Kali, openSUSE, Alpine, etc.).
Hacer clic en Obtener / Instalar y esperar a que finalice la descarga.
Una vez instalada, pulsar en Iniciar o abrirla desde el menú Inicio.

La primera vez que se ejecute, la distro completará su instalación interna (descompresión y configuración básica) y te pedirá crear un usuario Unix por defecto.

Instalación manual mediante paquetes .appx o .wsl

Si tu entorno no permite el uso de Microsoft Store (por ejemplo, en Windows Server, LTSC o equipos corporativos con políticas restrictivas), puedes instalar las distribuciones descargando los paquetes directamente:

Visita los enlaces oficiales de descarga de distros para WSL (Ubuntu, Debian, Kali, Oracle Linux, Fedora Remix, etc.).
Descarga el archivo .appx o .wsl de la distribución a una carpeta local.
En PowerShell, sitúate en esa carpeta y ejecuta:
Add-AppxPackage .\nombre_paquete.appx

También puedes usar comandos como Invoke-WebRequest o curl.exe para descargar los paquetes desde la línea de comandos, por ejemplo:

Invoke-WebRequest -Uri https://aka.ms/wslubuntu2004 -OutFile Ubuntu.appx -UseBasicParsing

Una vez instalado el paquete, podrás iniciar la distro haciendo doble clic en el archivo o buscándola por su nombre en el menú Inicio. Si estás en Server Core tendrás que seguir las instrucciones específicas de Microsoft para convertir el .appx a ZIP e instalarla manualmente.

Elegir y cambiar la distribución de Linux por defecto

Cuando utilizas el comando wsl –install sin parámetros, Windows instala por defecto Ubuntu. Si prefieres otra distribución (por ejemplo Debian o Kali), puedes indicarlo durante la instalación con:

wsl --install -d Debian

Para ver el listado de distribuciones disponibles para instalar mediante la tienda online o WSL, ejecuta en PowerShell:

wsl.exe --list --online

Si deseas cambiar la distro que se considera predeterminada (la que se arranca cuando ejecutas simplemente wsl sin parámetros), puedes hacerlo con:

wsl.exe --set-default <NombreDistro>

Por ejemplo:
wsl -s Debian
hará que, al lanzar wsl npm init desde PowerShell, ese comando se ejecute dentro de la distribución Debian.

Creación del usuario de Linux y primeros pasos

La primera vez que inicias una distribución recién instalada, se mostrará un texto indicando que la instalación puede tardar unos minutos y, a continuación, el sistema te pedirá crear un usuario Unix por defecto:

Installing, this may take a few minutes... Please create a default UNIX user account. Enter new UNIX username:

Es importante escoger bien este usuario, ya que será el que utilizarás habitualmente en WSL. Algunas recomendaciones útiles:

Comprobar qué versión de WSL estás usando

Cuando tienes varias distros instaladas, cada una puede estar usando WSL1 o WSL2. Para ver el listado con el detalle de cada una, abre PowerShell y ejecuta:

wsl.exe --list --verbose

Este comando muestra las distribuciones instaladas, si están en ejecución o detenidas, y la versión de WSL asociada. Otra variante muy utilizada es:

wsl -l -v

Si quieres cambiar la versión predeterminada para nuevas instalaciones entre WSL1 y WSL2, puedes usar:

wsl.exe --set-default-version <1|2>

Actualizar de WSL1 a WSL2 (o viceversa)

Si en su momento configuraste WSL1 o tu distro se instaló en esa versión y ahora quieres disfrutar de las ventajas de rendimiento y compatibilidad de WSL2, puedes migrarla fácilmente. Basta con ejecutar en PowerShell:

wsl.exe --set-version <Distro> <1|2>

Por ejemplo:
wsl --set-version Ubuntu 2
convertirá la distro Ubuntu para que use WSL2. El proceso puede tardar un rato si el sistema tiene muchos archivos, pero solo es necesario hacerlo una vez.

En caso de necesidad también puedes bajar de WSL2 a WSL1 usando el mismo comando con un 1 como versión. Esto puede ser útil en ciertas situaciones de compatibilidad muy específicas.

Si instalaste WSL manualmente antes de que existiera el comando wsl –install, es posible que tengas que habilitar la Plataforma de máquina virtual e instalar el paquete de kernel a mano para poder usar WSL2.

¿Cómo ejecutar y gestionar varias distribuciones con WSL?

WSL permite tener tantas distros de Linux como quieras instaladas en paralelo: puedes combinar Ubuntu para desarrollo general, Debian para entornos de producción, Kali para pruebas de seguridad, Alpine para servicios ligeros, etc.

Hay varias formas habituales de acceder a estas distribuciones una vez instaladas:

Terminal Windows (recomendado): puedes abrir múltiples pestañas y paneles, cada uno con una distro distinta o con PowerShell, cmd, Azure CLI, etc., y personalizar colores, fuentes, fondos y atajos de teclado.
Desde el menú Inicio, buscando el nombre de la distro (por ejemplo, «Ubuntu» o «Debian») y lanzándola como si fuera una aplicación más.
Invocando directamente el nombre de la distribución en PowerShell si está mapeado (por ejemplo, escribir ubuntu).
Ejecutando simplemente wsl.exe en PowerShell para abrir la distro predeterminada en la consola actual.
Usando wsl [comando] para ejecutar un comando concreto de Linux sin iniciar una nueva sesión interactiva, como wsl -l -v o wsl pwd.

Si en algún momento has entrado en WSL dentro de una consola de PowerShell y quieres volver al intérprete de Windows, basta con escribir exit para cerrar la sesión de la distro.

Buenas prácticas de configuración y uso en desarrollo

Una vez que tienes WSL2 funcionando, conviene dedicar un rato a afinar la configuración para que tu entorno de desarrollo sea cómodo y eficiente. Algunas recomendaciones:

Configurar correctamente tu usuario, shell e idioma dentro de la distro (por ejemplo, instalando tu shell favorita, ajustando locales, etc.).
Instalar y personalizar Windows Terminal para manejar varias sesiones de forma cómoda con pestañas, atajos y temas.
Configurar Git y control de versiones directamente en la distro de Linux, usando ssh para tus repositorios remotos.
Utilizar VS Code con la extensión Remote – WSL para editar y depurar proyectos dentro de Linux sin salir de Windows.
Cuidar dónde guardas tus archivos: es más eficiente trabajar con proyectos dentro del sistema de archivos de la distro (/home/usuario/proyecto) que en rutas de Windows montadas.
Si manejas bases de datos o servicios pesados, valorar la configuración de límites de memoria y CPU usando ajustes avanzados de WSL cuando trabajes con cargas intensivas.

Integración con Docker, cloud y entornos empresariales

Uno de los grandes atractivos de WSL2 es su integración con contenedores y servicios cloud. Al disponer de un kernel Linux real, Docker Desktop puede usar WSL2 como backend, ofreciendo un rendimiento mucho mejor que la virtualización clásica en Windows.

En entornos corporativos, WSL2 facilita la creación de pipelines CI/CD homogéneos, donde los desarrolladores trabajan en Linux sobre Windows y despliegan a servidores Linux en la nube (AWS, Azure, etc.) con mínimos cambios entre entornos.

Además, cada vez es más habitual combinar WSL2 con proyectos de inteligencia artificial, agentes IA, análisis de datos y business intelligence, aprovechando la amplia gama de herramientas de Linux (Python, R, frameworks de IA) mientras se mantiene la integración con herramientas de escritorio de Windows como Power BI u otros clientes corporativos.

En este tipo de escenarios es fundamental tener buenas políticas de ciberseguridad y copias de seguridad, gestionar el acceso a datos sensibles y cuidar la segmentación entre entornos de desarrollo y producción.

Seguridad y mantenimiento en WSL2

Aunque WSL2 se ejecuta dentro de una máquina virtual ligera gestionada por Windows, sigue siendo un entorno Linux completo, así que conviene aplicar medidas de seguridad similares a las de cualquier servidor:

Actualizar con frecuencia los paquetes de la distro (apt update && apt upgrade en Debian/Ubuntu, por ejemplo).
Usar usuarios sin privilegios para el día a día y recurrir a sudo solo cuando sea necesario.
Configurar y usar claves SSH en lugar de contraseñas para el acceso remoto.
Proteger tanto el sistema Windows como las distros con una buena solución de seguridad y firewall.
Planificar una estrategia de backups de los datos importantes, ya sea desde Windows o desde Linux, y si es posible integrarlos con servicios en la nube.

También es buena idea revisar de vez en cuando las actualizaciones de WSL con wsl --update y, si te interesa probar funciones nuevas antes que nadie, valorar el uso del parámetro --pre-release o unirte al programa Windows Insider.

Probar funciones en versión preliminar de WSL

Si te gusta estar a la última, puedes acceder a las novedades de WSL en fase de vista previa. Hay dos caminos:

Unirte al Programa Windows Insider y elegir un canal (Canal de desarrollo, beta, versión preliminar, etc.) para recibir builds de Windows con características nuevas de WSL.
Sin tocar tu canal de Windows, ejecutar:
wsl.exe --update --pre-release
para obtener la versión de WSL en vista previa directamente desde Microsoft.

Esto es especialmente útil para probar nuevas capacidades de GPU, mejoras de rendimiento o soporte ampliado de sistemas de archivos antes de que lleguen a la versión estable, aunque hay que asumir que puede haber bugs o comportamientos inestables.

Instalar WSL sin conexión a Internet

En entornos cerrados o con acceso restringido a Internet también es posible instalar WSL mediante un procedimiento offline. El flujo general sería:

Descargar en un equipo con acceso a Internet el paquete MSI más reciente de WSL desde la página de versiones en GitHub e instalarlo en el equipo destino.
Abrir PowerShell con permisos de administrador y habilitar la Plataforma de máquina virtual con:
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
reiniciando después.
Instalar una distribución a través de un archivo .wsl o .appx que hayas descargado previamente, usando Add-AppxPackage o siguiendo el procedimiento recomendado por Microsoft para Server.

De esta manera puedes tener un entorno WSL2 completamente funcional incluso en redes donde la Microsoft Store o las descargas directas están bloqueadas.