WSL

 Requisitos Previos (Muy Importante)

Antes de empezar, asegúrate de que tu versión de Windows 10 sea la 2004 o superior (compilación 19041 o superior). Si no estás seguro, puedes verificarlo así:

1. Presiona las teclas Windows + R.

2. Escribe winver y presiona Enter.

3. Revisa el número de versión que aparece en la ventana.

Si tu versión es anterior, no podrás usar el comando mágico que verás a continuación y tendrás que seguir el proceso de instalación manual.

---

Paso 1: Abrir PowerShell como Administrador

Este es el primer paso para todo. La terminal de PowerShell debe tener permisos de administrador para poder instalar WSL.

1. Haz clic en el botón de Inicio.

2. Escribe PowerShell.

3. En los resultados, haz clic derecho sobre Windows PowerShell y selecciona "Ejecutar como administrador".

Paso 2: El Comando Mágico para Instalar Todo

Ahora, en la ventana de PowerShell que se abrió, escribe el siguiente comando y presiona Enter:

powershell

wsl --install

¿Qué hace este comando? Es la forma más fácil y recomendada. En un solo paso, este comando se encarga de todo por ti:

• Habilita los componentes necesarios de Windows (WSL y la Plataforma de Máquina Virtual).

• Descarga e instala el kernel de Linux más reciente.

• Establece WSL 2 como la versión predeterminada, que es la más rápida y recomendada.

• Descarga e instala automáticamente la distribución de Ubuntu.

Paso 3: Reiniciar tu PC

Una vez que el comando termine, es muy probable que el sistema te pida que reinicies para aplicar todos los cambios. Hazlo sin falta. Al reiniciar, la instalación de Ubuntu continuará automáticamente.

Paso 4: Configurar Ubuntu (Crear tu Usuario y Contraseña)

Después del reinicio, busca "Ubuntu" en el menú de inicio y ábrelo.

• La primera vez que lo abras, verás un mensaje que dice "Installing, this may take a few minutes...". Espera a que termine.

• A continuación, el sistema te pedirá que crees un nombre de usuario y una contraseña para tu nueva instalación de Linux.

  Nota muy importante: Cuando escribas la contraseña, no verás ningún carácter en la pantalla. Esto es normal, es una medida de seguridad (se llama "blind typing"). Solo escribe tu contraseña y presiona Enter.

• Vuelve a escribir la contraseña para confirmarla.

¡Y ya está! Acabas de instalar Ubuntu dentro de Windows. A partir de ahora, cada vez que abras "Ubuntu" desde el menú inicio, estarás en una terminal de Linux totalmente funcional.

---

Posibles Problemas y Soluciones

• "El comando 'wsl --install' no se reconoce": Esto significa que tu versión de Windows es anterior a la 2004. Deberás seguir la guía de instalación manual.

• "El proceso de instalación se queda en 0.0%": Si ves que la instalación no avanza, puedes probar a usar este otro comando en PowerShell (como administrador) para forzar la descarga: wsl --install --web-download -d Ubuntu.

• "Subsistema de Windows para Linux no tiene distribuciones instaladas": Este es el error que te apareció antes. Significa que WSL está instalado, pero no hay ninguna distribución (como Ubuntu). Para solucionarlo, solo tienes que ejecutar el comando del Paso 2 (wsl --install).

Comandos Útiles para el Futuro

• wsl --list --online: Muestra todas las distribuciones de Linux que puedes instalar (como Ubuntu 20.04, Debian, Kali, etc.).

• wsl --install -d <NombreDistro>: Te permite instalar una distribución específica que no sea Ubuntu. Por ejemplo, wsl --install -d Debian.

• wsl: Este comando, escrito en PowerShell o CMD, te llevará directamente a la terminal de tu distribución de Linux por defecto (Ubuntu).

¡Listo! Ahora tienes un entorno Linux completo (Ubuntu) funcionando dentro de tu Windows 10, listo para que instales Docker o lo que necesites.

1. wsl --set-version Ubuntu 2

Qué hace: Intenta convertir tu distribución Ubuntu de WSL 1 a WSL 2.

Lo que ves:

• "Conversión en curso, esto puede tardar unos minutos..." → Normal.

• "WSL 2 requiere una actualización de su componente de kernel." → Esto es un error. Significa que te falta el kernel de Linux que necesita WSL 2 para funcionar.

Solución: Descargar e instalar el kernel desde aka.ms/wsl2kernel. Luego vuelve a ejecutar wsl --set-version Ubuntu 2.

---

2. wsl --list

Qué hace: Muestra todas las distribuciones de Linux que tienes instaladas en WSL.

Lo que ves:

• Ubuntu (predet.) → Tienes Ubuntu instalado y es la distribución predeterminada (cuando escribes wsl sin más, se abre esta).

Nota: Este comando no muestra la versión de WSL (1 o 2). Para eso necesitas wsl -l -v.

---

3. ws1 -l -v_ (error tipográfico)

Qué debería ser: wsl -l -v

Qué hace correctamente: Lista las distribuciones con su versión de WSL (1 o 2) y el estado (Running, Stopped).

Lo que ves: Escribiste ws1 en lugar de wsl, por eso el comando no se ejecutó. Cámbialo a wsl -l -v y verás algo como:

text

  NAME      STATE           VERSION
* Ubuntu    Stopped         1

Esto te confirmaría que tu Ubuntu está en WSL 1 (por eso necesitas convertirlo a 2).

---

4. wsl --set-default-version 2

Qué hace: Establece que todas las futuras distribuciones que instales usen WSL 2 por defecto.

Lo que ves: "La operación se completó correctamente." → Bueno, ya está configurado. Pero esto no afecta a la distribución Ubuntu que ya tenías instalada (sigue en WSL 1). Para cambiarla, debes usar el comando de la imagen 1.

---

5. wsl --list --online

Qué hace: Muestra las distribuciones de Linux disponibles para instalar desde los repositorios oficiales de Microsoft.

Lo que ves: Aparece "Ubuntu" y probablemente otras (Debian, Kali, etc.). La lista está truncada en la imagen, pero el comando completo te mostraría todas.

---

6. Fragmento 'wsl --install -d <Distribución>'

Es solo la instrucción que aparece en la ayuda del comando anterior. Te indica cómo instalar una distribución específica, por ejemplo:

powershell

wsl --install -d Debian

---

📌 Resumen de tu situación actual

Elemento	Estado
WSL habilitado	✅ Sí
Ubuntu instalado	✅ Sí
Versión de Ubuntu	❓ Probablemente WSL 1 (porque falló la conversión)
WSL 2 configurado como predeterminado	✅ Sí (para futuras instalaciones)
Kernel de WSL 2 instalado	❌ No (ese es el error)

---

🛠️ ¿Qué debes hacer ahora?

Paso 1: Instalar el kernel de WSL 2

• Ve a https://aka.ms/wsl2kernel (el enlace que te apareció en el error).

• Descarga el archivo .msi (por ejemplo, wsl_update_x64.msi).

• Ejecútalo como administrador (doble clic y sigue el asistente).

• Reinicia tu PC (o al menos cierra y vuelve a abrir PowerShell).

Paso 2: Convertir Ubuntu a WSL 2

Vuelve a ejecutar en PowerShell (administrador):

powershell

wsl --set-version Ubuntu 2

Espera a que termine (puede tardar unos minutos). Verás un mensaje de éxito.

Paso 3: Verificar que todo está bien

powershell

wsl -l -v

Deberías ver algo como:

text

  NAME      STATE           VERSION
* Ubuntu    Running         2

¡Eso significa que ya estás en WSL 2!

---

💡 Comandos adicionales útiles (para que los tengas a mano)

Comando	Descripción
wsl -l -v	Lista distribuciones con versión de WSL
wsl --status	Muestra la configuración actual de WSL (versión predeterminada, kernel, etc.)
wsl --shutdown	Apaga todas las distribuciones en ejecución (útil si algo se cuelga)
wsl --export Ubuntu backup.tar	Exporta tu distribución a un archivo (backup)
wsl --import Ubuntu nueva ruta backup.tar	Importa una distribución desde un backup
wsl ~	Abre la terminal de Ubuntu en tu directorio home

---

🔥 ¿Y ahora qué?

Con WSL 2 funcionando, puedes instalar Docker directamente dentro de Ubuntu (sin Docker Desktop en Windows) si quieres la experiencia 100% terminal. O si prefieres, instala Docker Desktop con integración WSL2 (opción que te recomendé antes).

Elige tu camino:

• Opción A (más fácil): Instala Docker Desktop con winget install Docker.DockerDesktop y cuando te pregunte, elige WSL2 como backend.

• Opción B (100% terminal): Dentro de Ubuntu (wsl), instala Docker con sudo apt install docker.io y úsalo desde allí.

•