Docker Desktop en Windows

Docker Desktop es la forma más sencilla de usar Docker en Windows. Incluye el motor de Docker, Docker Compose y una interfaz gráfica para gestionar contenedores.

Requisitos del sistema

Requisito	Detalle
Sistema operativo	Windows 10 (64-bit, versión 21H2 o superior) o Windows 11
RAM	Mínimo 4 GB (recomendado 8 GB)
CPU	Procesador de 64 bits con soporte de virtualización (Intel VT-x / AMD-V)
Disco	Al menos 5 GB de espacio libre
BIOS	Virtualización habilitada

---

Paso 1: Habilitar la virtualización en el BIOS

Docker necesita virtualización de hardware. En la mayoría de equipos modernos ya está habilitada, pero verifica:

1. Abre el Administrador de tareas (Ctrl + Shift + Esc)
2. Ve a la pestaña Rendimiento → CPU
3. Busca la línea Virtualización: Habilitada

Si dice Deshabilitada, debes entrar al BIOS/UEFI de tu equipo y habilitarla (el proceso varía según el fabricante — busca “Intel VT-x” o “AMD-V” en las opciones de CPU/Advanced).

---

Paso 2: Habilitar WSL 2

Docker Desktop en Windows usa WSL 2 (Windows Subsystem for Linux 2) como motor de virtualización. Es más ligero y rápido que Hyper-V.

Abre PowerShell como administrador y ejecuta:

# Habilitar el subsistema de Windows para Linux
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# Habilitar la plataforma de máquina virtual
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Reinicia el equipo.

Después del reinicio, instala el paquete de actualización del kernel de Linux:

# Descargar e instalar la actualización del kernel de Linux para WSL 2
wsl --update

# Establecer WSL 2 como versión predeterminada
wsl --set-default-version 2

Consejo

Si el comando wsl --update no funciona, descarga el instalador manualmente desde: https://aka.ms/wsl2kernel

---

Paso 3: Descargar Docker Desktop

1. Ve a https://www.docker.com/products/docker-desktop/
2. Haz clic en Download for Windows
3. Descarga el instalador Docker Desktop Installer.exe

---

Paso 4: Instalar Docker Desktop

1. Ejecuta Docker Desktop Installer.exe como administrador
2. En la pantalla de configuración, asegúrate de que esté marcado:
   • ✅ Use WSL 2 instead of Hyper-V (recomendado)
   • ✅ Add shortcut to desktop
3. Haz clic en Ok y espera que finalice la instalación (~3–5 minutos)
4. Haz clic en Close and restart para reiniciar el equipo

---

Paso 5: Configuración inicial

Al iniciar Docker Desktop por primera vez:

1. Acepta los términos de servicio
2. Puedes omitir el tutorial inicial (Skip tutorial)
3. En la pantalla de inicio de sesión, puedes crear una cuenta gratuita en hub.docker.com o continuar sin cuenta haciendo clic en Continue without signing in

Docker Desktop tardará ~30 segundos en iniciar el motor (verás el ícono de Docker en la barra de tareas).

---

Paso 6: Verificar la instalación

Abre PowerShell o el Símbolo del sistema y ejecuta:

# Verificar la versión de Docker
docker --version
# Salida esperada: Docker version 27.x.x, build ...

# Verificar Docker Compose
docker compose version
# Salida esperada: Docker Compose version v2.x.x

# Prueba rápida: correr el contenedor "hello-world"
docker run hello-world

Si ves el mensaje Hello from Docker!, la instalación fue exitosa. ✅

---

Paso 7: Instalar una distribución Linux para WSL 2 (recomendado)

Para trabajar con Docker desde una terminal Linux real en Windows:

# Ver distribuciones disponibles
wsl --list --online

# Instalar Ubuntu (recomendado)
wsl --install -d Ubuntu

Después de la instalación, abre Ubuntu desde el menú inicio, crea tu usuario y contraseña de Linux, y verifica que Docker funcione:

docker run hello-world

Nota

Docker Desktop comparte el motor con WSL 2 automáticamente. No necesitas instalar Docker dentro de Ubuntu — los comandos docker y docker compose ya funcionan en la terminal de Ubuntu.

---

Configuraciones recomendadas de Docker Desktop

Ve a Settings (⚙️ en la barra superior):

General

• ✅ Start Docker Desktop when you sign in to your computer — Docker arranca automáticamente al iniciar Windows

Resources → Advanced

• Memory: Asigna al menos 4 GB si tu equipo tiene 8 GB o más de RAM. Los stacks IoT con 3+ servicios pueden requerir memoria extra.
• CPUs: Deja al menos la mitad de tus núcleos disponibles

Resources → WSL Integration

• Habilita la integración con tu distribución de Ubuntu para que los comandos Docker funcionen desde la terminal de Linux

---

Solución de problemas comunes

”WSL 2 installation is incomplete”

wsl --update
wsl --set-default-version 2

Reinicia Docker Desktop desde la bandeja del sistema.

”Hardware assisted virtualization and data execution protection must be enabled”

Entra al BIOS y habilita Intel VT-x o AMD-V. Cada fabricante tiene su combinación de teclas para entrar al BIOS (F2, F10, Del, etc.) — consulta el manual de tu equipo.

Docker Desktop no inicia / se queda en “Starting…”

# En PowerShell como administrador:
wsl --shutdown
# Luego abre Docker Desktop nuevamente

El ícono de Docker no aparece en la barra de tareas

Busca Docker Desktop en el menú inicio y ábrelo manualmente. Si no aparece, reinstala siguiendo los pasos anteriores.

---

Próximos pasos

Una vez que Docker Desktop esté funcionando, continúa con:

• Conceptos básicos de Docker — imágenes, contenedores, volúmenes y redes
• Introducción a Docker Compose — gestiona múltiples servicios con un archivo YAML