Cómo instalar Docker en Windows 11: Guía de 5 minutos (2025)

Su plataforma de 5 minutos para Docker en Windows 11

Docker es una plataforma abierta que ha cambiado radicalmente el desarrollo moderno de software. Aprovecha la contenedorización para empaquetar aplicaciones y sus dependencias en unidades ligeras, aisladas y portátiles llamadas contenedores. This technology elegantly solves the classic and often frustrating “it works on my machine” problem by ensuring that an application runs consistently across development, testing, and production environments. Al final de esta completa guía, cualquier desarrollador o entusiasta de la tecnología tendrá un entorno Docker totalmente funcional en su PC con Windows 11, listo para crear, compartir y ejecutar aplicaciones en contenedores con confianza.   

The “5-minute” claim in the title refers specifically to the active installation and command execution time a user will spend. It is important to set realistic expectations: passive waiting periods for software downloads, system reboots, and the initial, one-time setup of the Windows Subsystem for Linux (WSL) are not included in this estimate. Esta guía está estructurada para que el proceso activo sea lo más rápido y libre de errores posible, abordando los requisitos previos de forma exhaustiva y por adelantado.  

Este informe proporcionará una hoja de ruta completa para el proceso de instalación. Comienza con una comprobación previa crítica de los requisitos del sistema, pasa a la instalación de WSL 2 y Docker Desktop, cubre la verificación de la configuración y culmina con el lanzamiento de un contenedor de servidor web Nginx práctico y real.   

Para empezar, es útil entender algunos conceptos básicos de Docker. Un Imagen es un plano o plantilla de sólo lectura que contiene el código de la aplicación, un tiempo de ejecución, herramientas del sistema y todas las dependencias necesarias. A   

Contenedor es una instancia viva y en ejecución de una imagen. Es el entorno autónomo en el que se ejecuta la aplicación.   

Escritorio Docker es la aplicación fácil de instalar para Windows que agrupa el motor Docker (el servicio central en segundo plano o demonio), la interfaz de línea de comandos (CLI) para interactuar con él y otras herramientas esenciales en un único paquete fácil de usar. El principal beneficio de este ecosistema es la coherencia que proporciona, que acelera drásticamente los flujos de trabajo de desarrollo y reduce los errores relacionados con el entorno.   

Lista de comprobación previa al vuelo: ¿Está su PC con Windows 11 preparado para Docker?

Dedicating a few minutes to this pre-flight checklist is the single most important step to ensure a smooth and rapid installation. This section is designed to proactively address the most common points of failure, preventing hours of troubleshooting cryptic error messages later. A significant number of installation failures are not due to Docker itself but stem from a cascade of underlying system misconfigurations. For instance, a disabled virtualization setting in the computer’s firmware will prevent the Windows Subsystem for Linux (WSL 2) from functioning correctly. This, in turn, will cause the Docker Desktop installation to fail with vague errors like “Unexpected WSL error” or “This app can’t run on your PC”. Esta lista de comprobación rompe esa cadena de fallos antes de que empiece, transformando una experiencia potencialmente frustrante en una sencilla.   

Requisitos del sistema

Antes de proceder, es esencial confirmar que la máquina anfitriona cumple los requisitos oficiales del sistema para Docker Desktop en Windows 11. Los requisitos más recientes son los siguientes :   

• Sistema operativo: Se requiere una versión de 64 bits de Windows 11. Puede ser la edición Home, Pro, Enterprise o Education. Se recomienda encarecidamente estar en la versión 22H2 o superior para obtener la mejor compatibilidad y rendimiento.
• Procesador: El sistema debe tener un procesador de 64 bits con traducción de direcciones de segundo nivel (SLAT). Casi todas las CPU modernas fabricadas en la última década incluyen esta función.
• RAM: Se requiere un mínimo de 4 GB de RAM del sistema. Sin embargo, para una experiencia suave y sensible, Se recomiendan 8 GB de RAM o más. Tanto Docker Desktop como los contenedores que ejecuta consumirán memoria, y 4 GB pueden convertirse en un importante cuello de botella durante el desarrollo.   

El paso más crítico: Habilitar la virtualización del hardware

Docker on Windows does not run applications natively; it relies on hardware virtualization to run a lightweight Linux kernel through WSL 2. If this feature is disabled in the system’s BIOS/UEFI, Docker Desktop cannot function.   

Cómo comprobar si la virtualización está activada

Se puede realizar una comprobación rápida sin reiniciar el sistema:

1. Pulse Ctrl + Mayús + Esc para abrir el Administrador de tareas de Windows.
2. Navegue hasta el Rendimiento ficha.
3. Seleccione CPU del panel izquierdo.
4. En el lado derecho, busque el Virtualización estado. Si dice Activadono es necesario realizar ninguna acción en este paso. Si se lee DiscapacitadosDebe habilitarse en la configuración BIOS/UEFI antes de continuar.   

Cómo activar la virtualización en BIOS/UEFI

Para activar la virtualización es necesario reiniciar el ordenador e introducir la configuración del firmware. Los pasos exactos pueden variar según el fabricante, pero el proceso general es el mismo.

El método moderno para acceder a la configuración del firmware UEFI en Windows 11 es el siguiente :   

1. Abra el Ajustes navegue hasta Sistemay, a continuación, seleccione Recuperación.
2. Under the “Advanced startup” section, click the Reiniciar ahora botón.
3. El ordenador se reiniciará en el entorno de recuperación de Windows. Desde aquí, seleccione Troubleshoot > Advanced options > UEFI Firmware Settings y haga clic en Reinicie.

Como alternativa, el método tradicional consiste en pulsar una tecla específica durante la secuencia inicial de arranque. La tecla correcta depende del fabricante.   

Once inside the BIOS/UEFI menu, the virtualization setting is typically located under an “Advanced,” “CPU Configuration,” or “Security” tab. The option will be labeled as Tecnología de virtualización Intel (VT-x), AMD-Vo Modo SVM. Este ajuste debe cambiarse a   

Activado. Después de habilitarlo, es crucial guardar los cambios y salir de la BIOS/UEFI, lo que hará que el ordenador se reinicie.

Para ayudar en este proceso, la siguiente tabla enumera las claves de acceso BIOS/UEFI comunes para los principales fabricantes de PC.

Fabricante	Claves comunes
Dell	F2, F12
HP	Esc, F10
Lenovo	F1, F2, Fn+F2
ASUS	F2, Del
MSI / Gigabyte	Del
Tabla 1: Claves de acceso BIOS/UEFI comunes por fabricante, recopiladas de guías de usuario y documentación de soporte.

La Fundación: Instalación del subsistema Windows para Linux (WSL 2)

Una vez confirmados los requisitos previos, el siguiente paso es instalar la base sobre la que se ejecutará Docker: el subsistema de Windows para Linux, versión 2 (WSL 2). Docker Desktop utiliza WSL 2 como backend para ejecutar contenedores Linux directamente en Windows, ofreciendo un rendimiento casi nativo, tiempos de arranque más rápidos y una integración superior del sistema de archivos en comparación con el antiguo backend Hyper-V.   

Instalación con un solo comando

Microsoft ha simplificado la instalación de WSL 2 en un único y potente comando.

1. Abrir Windows PowerShell o Símbolo del sistema con permisos elevados haciendo clic con el botón derecho sobre su icono en el menú Inicio y seleccionando Ejecutar como administrador.
2. Ejecute el siguiente comando : Fragmento de códigowsl --instalar

This one command automates several steps that previously had to be done manually. It enables the necessary “Virtual Machine Platform” and “Windows Subsystem for Linux” features, downloads the latest Linux kernel from Microsoft, sets WSL 2 as the default version, and installs the Ubuntu distribution of Linux by default.   

Reinicio y configuración tras la instalación

Una vez completado el comando, es necesario reiniciar el sistema para finalizar la instalación de las nuevas características de Windows.Al reiniciar, se abrirá automáticamente una ventana de consola para que Ubuntu complete su configuración inicial. Este proceso implica la creación de un nuevo nombre de usuario y contraseña UNIX. Es importante tener en cuenta que estas credenciales son para el entorno Linux y son totalmente independientes de las credenciales de inicio de sesión estándar de Windows.   

El evento principal: Instalación de Docker Desktop

Con WSL 2 en su lugar, el sistema ya está listo para la instalación principal de Docker Desktop.

Descargar el instalador correcto

El instalador oficial debe descargarse directamente del sitio web de Docker para garantizar su autenticidad y obtener la versión más reciente.   

Un detalle crítico y que a menudo se pasa por alto es la arquitectura del sistema. El instalador para procesadores Intel y AMD estándar es el x86_64 (o AMD64) version. Community forums are filled with reports from users who encountered an immediate “This app can’t run on your PC” error because they accidentally downloaded the ARM64 installer, which is intended for devices like the Surface Pro X. The download page’s user interface can sometimes be confusing, so it is vital to double-check that the correct version is being downloaded.   

El proceso de instalación

1. Localice el archivo descargado Docker Desktop Installer.exe archivo.
2. Haga doble clic en el instalador para ejecutarlo. Solicitará privilegios de administrador, necesarios para la instalación.  
3. La pantalla principal de configuración presenta una elección crucial. Asegúrese de que la “Use WSL 2 instead of Hyper-V”está marcada. Esto configura Docker para utilizar el backend moderno y recomendado para un rendimiento óptimo.La opción de añadir un acceso directo al escritorio es una cuestión de preferencia del usuario.   

Permisos posteriores a la instalación (Los docker-users Grupo)

Aunque los derechos de administrador son necesarios para la instalación, no son necesarios para el uso diario de Docker. Sin embargo, para que una cuenta de usuario estándar (no de administrador) se comunique con el demonio Docker, debe añadirse a la cuenta de usuario local docker-users que se crea durante la instalación.   

Para añadir un usuario a este grupo:

1. Abra el Gestión informática utilidad. Puede encontrarla buscándola en el menú Inicio. Debe ejecutarse como administrador.
2. En el panel izquierdo, vaya a Local Users and Groups > Groups.
3. Localice y haga clic con el botón derecho del ratón en docker-users y, a continuación, seleccione Add to Group….
4. Haga clic en el botón Add… escriba el nombre de la cuenta de usuario a la que se concederá acceso a Docker y haga clic en OK.
5. Después de añadir el usuario, es esencial cerrar sesión en Windows y volver a iniciarla. Este paso es obligatorio para que la nueva pertenencia al grupo surta efecto; un simple reinicio no siempre es suficiente.   

¡Despegue! Verificación y su primer contenedor en el mundo real

Una vez completada la instalación y la configuración, es hora de verificar la instalación y lanzar un contenedor. Esta sección confirma que todos los componentes funcionan correctamente y proporciona un resultado tangible.

El apretón de manos de la línea de comandos

Abra un nuevo terminal PowerShell o Símbolo del sistema. Si la cuenta de usuario se añadió a la docker-users grupo, este terminal debe no debe ejecutarse como administrador, para comprobar que los permisos funcionan correctamente.

En primer lugar, compruebe que la CLI Docker puede comunicarse con el demonio Docker mediante la comprobación de la versión:

Fragmento de código

docker --version

Esto debería devolver la versión de Docker instalada, por ejemplo, Docker versión 25.0.3, build 4debf41.

A continuación, ejecute el comando para listar los contenedores activos:

Fragmento de código

docker ps

Dado que aún no hay contenedores en ejecución, este comando debería devolver una tabla vacía con solo los encabezados de columna (ID de contenedor, IMAGEN, etc.). Esta respuesta exitosa y vacía confirma que la CLI está correctamente conectada al motor Docker.   

The “Hello World” Ritual

El primer paso tradicional en el mundo Docker es ejecutar la aplicación hola-mundo imagen. Esto sirve como prueba definitiva de todo el sistema.

Fragmento de código

docker run hola-mundo

Este comando realiza varias acciones: comprueba si existe el hola-mundo image locally, downloads it from the Docker Hub image repository if it’s not found, creates a new container from that image, runs the container, and prints a confirmation message to the terminal before exiting. A successful run will display a message beginning with “Hello from Docker!”   

Aplicación práctica: Lanzamiento de un servidor web Nginx

En hola-mundo confirms the system works, it doesn’t demonstrate practical usage. A far more engaging and instructive first step is to launch a live web server. This introduces core concepts like port mapping and detached mode, providing an interactive result that solidifies understanding. This approach bridges the gap from a simple installation check to genuine, practical application.   

Para lanzar un contenedor de servidor web Nginx, ejecute el siguiente comando:

Fragmento de código

docker run -d -p 8080:80 --name mi-servidor-web nginx

Cada parte de este comando tiene una función específica:

• docker run: El comando principal para crear e iniciar un nuevo contenedor.
• -d o --detach: Ejecuta el contenedor en segundo plano, liberando el terminal para otros comandos.
• -p 8080:80 o --publicar 8080:80: Maps port 8080 on the host machine (the PC) to port 80 inside the container. Nginx listens on port 80 by default, so this makes it accessible from the host’s browser.
• --name mi-servidor-web: Asigna un nombre legible al contenedor para facilitar su gestión.
• nginx: Especifica la imagen oficial de Nginx que se utilizará, que Docker extraerá de Docker Hub.

Para verificar que el servidor web está funcionando, abra un navegador web y navegue hasta la dirección http://localhost:8080. The “Welcome to nginx!” page should be displayed, confirming the container is running and accessible.

For an even more powerful demonstration, the default page can be customized using a bind mount. This links a directory on the host machine directly into the container’s filesystem.

1. En primer lugar, detenga y retire el contenedor existente: docker stop mi-servidor-web seguido de docker rm mi-servidor-web.
2. Cree una nueva carpeta en el Escritorio con el nombre mi-sitio.
3. Dentro de esta carpeta, cree un nuevo archivo de texto llamado index.html.
4. Abrir index.html y añada el siguiente contenido: <h1>¡Hola desde mi primer contenedor Docker!</h1>.
5. Ahora, ejecute un nuevo contenedor con un volumen (-v) para montar el directorio local. La ruta debe ser una ruta absoluta.Fragmento de códigodocker run -d -p 8080:80 --name mi-servidor-web -v C:/usr/share/nginx/html nginx (Sustituir TuNombreDeUsuario con el nombre de usuario real de Windows).
6. Actualice el navegador en http://localhost:8080. It will now display the custom “Hello from my first Docker container!” message. This demonstrates the power of bind mounts for live development.   

Su kit esencial de herramientas de comandos Docker

Ahora que un contenedor se está ejecutando, se necesitan algunos comandos esenciales para gestionarlo. Esta sección sirve como una hoja de referencia rápida para las operaciones más comunes del día a día de Docker, permitiendo a los usuarios interactuar y controlar inmediatamente su nuevo entorno en contenedores.   

Comando	Descripción	Ejemplo de uso
docker ps	Lista todos los contenedores en ejecución.	docker ps
docker ps -a	Lista todos los contenedores, incluidos los que están parados.	docker ps -a
docker stop	Detiene un contenedor en ejecución.	docker stop mi-servidor-web
docker start	Inicia un contenedor previamente detenido.	docker start mi-servidor-web
docker rm	Elimina un parado contenedor de forma permanente.	docker rm mi-servidor-web
imágenes docker	Lista todas las imágenes Docker almacenadas localmente en la máquina.	imágenes docker
docker rmi	Elimina una imagen local (sólo si ningún contenedor la está utilizando).	docker rmi nginx
docker logs	Obtiene los registros de salida estándar de un contenedor.	docker logs mi-servidor-web
docker logs -f	Sigue la salida de registros en tiempo real, transmitiendo nuevos registros.	docker logs -f mi-servidor-web
docker exec -it	Ejecuta un comando dentro de un contenedor en ejecución (por ejemplo, abre un shell).	docker exec -it mi-servidor-web bash
Tabla 2: Lista de comandos esenciales de Docker para principiantes.

Solución de problemas: Guía de errores comunes de instalación y ejecución

Incluso con una preparación cuidadosa, pueden surgir problemas. Esta sección sirve como botiquín de primeros auxilios, abordando los errores de instalación y ejecución más comunes. Estas preguntas se formulan para que coincidan exactamente con los mensajes de error que los usuarios suelen buscar, lo que convierte a esta guía en un valioso recurso durante la resolución de problemas.

FAQ 1: Why am I getting an “Unexpected WSL error”?

• Síntomas: Docker Desktop no se inicia y muestra una ventana emergente con este error, a menudo mencionando problemas de derechos de acceso o sugiriendo un wsl --apagado mando.   
• Soluciones: Estos pasos deben intentarse en orden.
  1. Reinicio sencillo: Abra PowerShell y ejecute wsl --apagado. Este comando detiene completamente la máquina virtual WSL 2. Espere unos segundos e intente reiniciar Docker Desktop. Esto suele resolver los problemas de estado transitorios.   
  2. Reinicio de la pila de red: Si el problema persiste, puede deberse a una corrupción en la pila de red de Windows que facilita la comunicación con WSL. Abra PowerShell como administrador y ejecute netsh winsock reset. Se requiere un reinicio del sistema después de este comando.   
  3. Compruebe el Tipo de Lanzamiento del Hipervisor: Asegúrese de que el hipervisor de Windows está configurado para iniciarse automáticamente. Abra un PowerShell de administrador y ejecute bcdedit /set hypervisorlaunchtype Autoy reinicie.   
  4. Ciclo completo de reactivación: Como último recurso, se pueden reinstalar completamente los componentes de virtualización. En un PowerShell de administrador, ejecute los siguientes comandos para desactivar las funciones: DISM /Online /desactivar-característica /nombre-de-la-característica:VirtualMachinePlatform DISM /Online /desactivar-característica /nombre-de-la-característica:Microsoft-Windows-Subsystem-Linux Reinicie el ordenador. A continuación, abra otro PowerShell administrador y volver a habilitarlos: DISM /Online /enable-Feature /FeatureName:Microsoft-Windows-Subsystem-Linux DISM /Online /enable-Feature /FeatureName:VirtualMachinePlatform Reinicia una última vez.   

FAQ 2: Docker Desktop won’t start after I close it or restart my PC. What’s wrong?

• Síntomas: La aplicación funcionaba perfectamente tras la instalación inicial, pero ahora no se inicia. Puede que el icono de Docker aparezca en la bandeja del sistema y luego desaparezca, o que no ocurra nada en absoluto.
• Solución: Este problema suele deberse a procesos en segundo plano que no han finalizado correctamente.
  1. Abrir Gestor de tareas (Ctrl + Mayús + Esc).
  2. Ir a la Detalles ficha.
  3. Ordenar por nombre y buscar cualquier proceso llamado Docker Desktop.exe o que impliquen al backend de Docker.
  4. Seleccione cada uno de estos procesos y haga clic en Fin de la tarea.
  5. Una vez finalizados todos los procesos relacionados, intente iniciar Docker Desktop de nuevo.   

FAQ 3: The installer says “This app can’t run on your PC.” How do I fix it?

• Síntomas: En Docker Desktop Installer.exe falla inmediatamente tras su ejecución con este mensaje de error genérico de Windows.
• Solución:
  1. Causa principal: La razón más común de este error es un desajuste de arquitectura. Es probable que el usuario haya descargado el ARM64 para un PC estándar con procesador Intel o AMD. Vuelva al sitio web oficial de Docker y asegúrese de que el x86_64 / AMD64 se descarga la versión.   
  2. Causa secundaria: Si se utilizó el instalador correcto, este error indica que no se cumple un requisito previo del núcleo del sistema. Vuelva a la Sección 1 de esta guía y compruebe que la virtualización de hardware está activada en la BIOS/UEFI.

FAQ 4: Mi instalación falló con un error sobre la virtualización o WSL.

• Síntomas: The installer shows an error message such as “WSL 2 installation is incomplete,” “Docker Desktop requires a WSL 2 backend,” or another message explicitly mentioning virtualization.
• Solución: Esto es un claro indicador de que se ha omitido un requisito previo o no está configurado correctamente.
  1. Reinicie y entre en la BIOS/UEFI para confirmar que Intel VT-x o AMD-V es Activado. Este es el punto de fallo más común.
  2. Ensure the “Virtual Machine Platform” Windows feature is turned on. To be certain, run dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart en un PowerShell de administrador y reinicie.   

FAQ 5: I’m getting “permission denied” or “daemon is not running” errors when I run dockercomandos.

• Síntomas: En un terminal de no administrador, comandos como docker ps fallan con un error que indica que el cliente no puede conectarse al demonio Docker.
• Solución: Se trata de un problema clásico de permisos.
  1. Confirme que la cuenta de usuario actual es miembro de la red docker-users grupo local, como se detalla en la sección 3.
  2. Sobre todo, el usuario debe cerrar sesión en Windows y volver a iniciarla para que el cambio de pertenencia a un grupo se aplique a su ficha de seguridad. No basta con reiniciar o cerrar y volver a abrir el terminal.

Conclusión: Su viaje a Docker comienza ahora

Siguiendo esta guía, un usuario ha preparado con éxito su sistema Windows 11, ha instalado los prerrequisitos necesarios como WSL 2, ha instalado y configurado Docker Desktop, ha verificado la instalación completa y ha lanzado un contenedor Nginx del mundo real. Este logro proporciona una base potente y estable para el desarrollo de software moderno.

Con un entorno Docker funcional, comienza realmente el viaje hacia la contenedorización. Los siguientes pasos lógicos para ampliar esta base incluyen:

• Aprendiendo Docker Compose: Para las aplicaciones que constan de varios servicios (como una aplicación web, una base de datos y una capa de almacenamiento en caché), Docker Compose es la herramienta estándar. Permite definir y gestionar una pila completa de aplicaciones multicontenedor mediante un único archivo de configuración YAML, lo que simplifica los despliegues complejos en un solo comando.   
• Escribiendo un Dockerfile: El verdadero poder de Docker se hace realidad cuando se empaquetan aplicaciones personalizadas. El siguiente paso es aprender a escribir un Dockerfile, which is a text file containing step-by-step instructions for building a custom Docker image from an application’s source code.   
• Explorando Docker Hub: Docker Hub es un vasto registro público que contiene miles de imágenes preconstruidas para diversas aplicaciones y servicios. Es un recurso inestimable para encontrar imágenes oficiales y también es la plataforma para compartir imágenes creadas a medida con la comunidad o un equipo privado.