Explorador
Práctica

Instalar WSL y la primera distro

Instalar WSL 2 en Windows 11, elegir distribución y completar el primer arranque de Ubuntu.

Actualizado el

En esta guía

Instalar

Antes conviene repasar los requisitos previos. En PowerShell como administrador:

wsl --install

Activa las características de Windows necesarias, deja WSL 2 como versión por defecto e instala Ubuntu. Hay que reiniciar el equipo cuando lo pida.

Elegir otra distribución

wsl --list --online          # distribuciones disponibles (abreviado: wsl -l -o)
wsl --install -d Debian      # instalar una específica

Primer arranque

La distro se abre desde el menú Inicio (Ubuntu) o desde PowerShell con wsl -d Ubuntu. La primera vez tarda un minuto descomprimiendo y luego pide:

  1. Nombre de usuario UNIX: en minúsculas y sin espacios. No tiene que coincidir con el de Windows.
  2. Contraseña: al escribirla no se muestra nada, ni asteriscos. Es normal. Es la que se usará con sudo.

Actualizar el sistema

sudo apt update && sudo apt upgrade -y

Comprobar que todo está bien

whoami                    # el usuario creado
pwd                       # debería ser /home/usuario
cat /etc/os-release       # distro y versión

Desde PowerShell:

wsl -l -v                 # la distro debe aparecer con VERSION 2
wsl --status

Si la instalación falla

Casi siempre falta alguno de los requisitos previos: versión de Windows, virtualización en la BIOS, características de Windows o el hipervisor en el arranque. Esa guía incluye la tabla de errores y qué revisar en cada caso.

Si wsl --install solo muestra el texto de ayuda, WSL ya está instalado y lo que falta es la distro:

wsl --list --online
wsl --install -d Ubuntu

Si la descarga se queda en 0.0 %:

wsl --install --web-download -d Ubuntu

Siguiente paso

Con la distro lista, lo primero suele ser instalar y configurar Git.