Instalar con wsl --install · WSL2: Linux dentro de Windows en 40 minutos

En un Windows 11 al día, instalar WSL2 con Ubuntu es un comando, un reinicio y un usuario.

Ficha de wsl

Nombre: wsl viene de Windows Subsystem for Linux. Dentro de Linux se escribe wsl.exe.
Qué hace: instala, lista, apaga, actualiza y respalda distribuciones, y ejecuta comandos de Linux desde Windows (wsl ls -la).

Sintaxis

wsl [OPCIÓN] [ARGUMENTOS]
wsl --install [-d DISTRIBUCIÓN] [--web-download]
wsl [-d DISTRIBUCIÓN] [COMANDO_DE_LINUX]

Opciones principales

Opción	Qué hace	Ejemplo
`--install`	Activa WSL e instala Ubuntu	`wsl --install`
`-d NOMBRE`	Elige la distribución al instalar o al abrir	`wsl --install -d Ubuntu-24.04`
`-l -o` (`--list --online`)	Lista las distribuciones que se pueden instalar	`wsl -l -o`
`-l -v` (`--list --verbose`)	Lista las instaladas, su estado y su versión de WSL	`wsl -l -v`
`--update` / `--version`	Actualiza WSL / muestra sus versiones	`wsl --update`
`--shutdown`	Apaga todas las distribuciones y la VM	`wsl --shutdown`
`--unregister NOMBRE`	Borra la distribución con todos sus archivos, sin preguntar	`wsl --unregister Ubuntu-prueba`

Instalar Ubuntu

Clic derecho en Inicio y elija Terminal (Administrador) en Windows 11 o Windows PowerShell (Administrador) en Windows 10:

PS C:\Windows\system32> wsl --install
Instalando componente opcional de Windows: VirtualMachinePlatform
(...)

Reinicie y abra Ubuntu desde Inicio. Cree un usuario y una contraseña de Linux; esa contraseña es la de sudo y no se ve al escribirla.

Provisioning the new WSL instance Ubuntu
This might take a while...
Create a default Unix user account: keilor
New password:
Retype new password:
passwd: password updated successfully

Lo primero que hago en una distribución nueva: sudo apt update && sudo apt upgrade -y.

wsl --install instala Ubuntu, que hoy apunta a Ubuntu 26.04 LTS. Si un curso pide otra versión, use el nombre de la primera columna:

PS C:\Users\keilor> wsl --list --online
A continuación se muestra una lista de distribuciones válidas que se pueden instalar.
Instalar con "wsl.exe --install <Distro>".
 
NAME                            FRIENDLY NAME
(...)
Ubuntu                          Ubuntu
Ubuntu-26.04                    Ubuntu 26.04 LTS
Ubuntu-24.04                    Ubuntu 24.04 LTS
(...)

Comprobar que es WSL 2

PS C:\Users\keilor> wsl -l -v
  NAME      STATE           VERSION
* Ubuntu    Running         2
PS C:\Users\keilor> wsl --version
Versión de WSL: 3.0.3.0
Versión de kernel: 6.18.54.1-1
(...)

El asterisco marca la predeterminada; las columnas salen en inglés aunque Windows esté en español. Si VERSION dice 1: wsl --set-version Ubuntu 2.

Errores frecuentes

Error: 0x80370102 The virtual machine could not be started because a required feature is not installed.

Las versiones recientes dicen "WSL2 no se puede iniciar porque la virtualización no está habilitada en esta máquina". Entre al firmware al encender (en muchas laptops, F2 o Supr) y active Intel VT-x o SVM Mode. Si ya estaba activa, ejecute wsl.exe --install --no-distribution, que habilita la Plataforma de máquina virtual, y reinicie.

Si wsl --install solo imprime la ayuda, WSL ya estaba instalado y falta la distribución: wsl --install -d Ubuntu. Si se queda en 0,0 %, agregue --web-download.

En una laptop de empresa, WSL puede estar desactivado por política o sin red por el firewall corporativo. No se salte la política: pida acceso a soporte técnico o use un equipo propio.

La mirada del defensor

MITRE ATT&CK cuenta wsl.exe entre las utilidades de ejecución indirecta (T1202). Un wsl.exe cuyo proceso padre es Word o un script merece una segunda mirada; la lección 5 sigue con el EDR.