Guía paso a paso: Instalación de Docker Desktop en Windows y macOS
Empiece a usar Docker instalando Docker Desktop en Windows y macOS. Esta guía paso a paso cubre los requisitos previos, las instrucciones de descarga, los procedimientos de instalación y los pasos de verificación inicial para ambos sistemas operativos. Aprenda a configurar su entorno de desarrollo para una contenerización eficiente.
Guía paso a paso: Instalación de Docker Desktop en Windows y macOS
Docker Desktop es el punto de partida habitual cuando deseas ejecutar contenedores en una laptop con Windows o macOS. La instalación es simple, pero algunas configuraciones del sistema pueden impedir que Docker se inicie después de que el instalador termine.
Esta guía te lleva a través de la instalación de Docker Desktop en Windows y macOS, y luego verifica que la CLI de Docker, el motor de Docker y un contenedor de prueba funcionen correctamente.
Qué instala Docker Desktop
Docker Desktop te proporciona un entorno Docker local con la CLI de Docker, el motor de Docker, Docker Compose, un panel de escritorio y soporte opcional para Kubernetes. En Windows, Docker Desktop normalmente ejecuta contenedores Linux a través de WSL 2. En macOS, ejecuta contenedores dentro de una máquina virtual Linux ligera.
Para el desarrollo diario, esto significa que puedes ejecutar comandos como:
docker run hello-world
docker compose up
docker build -t my-app .
No necesitas instalar un paquete separado del motor de Docker primero.
Verifica los requisitos primero
Docker cambia los requisitos de la plataforma con el tiempo, así que consulta la documentación actual de Docker antes de instalar en máquinas más antiguas. En la mayoría de las configuraciones actuales, debes confirmar estos aspectos básicos.
Requisitos para Windows
Usa una edición de Windows de 64 bits compatible y mantén Windows actualizado. Docker Desktop funciona mejor con el backend WSL 2, así que instala WSL antes o durante la configuración:
wsl --install
Ejecuta ese comando desde una PowerShell o Símbolo del sistema elevados, luego reinicia si Windows te lo solicita.
También verifica la virtualización de hardware. Abre el Administrador de tareas, ve a Rendimiento, selecciona CPU y busca Virtualización: Habilitada. Si está deshabilitada, actívala en la configuración de BIOS o UEFI.
Docker Desktop es para entornos de escritorio Windows, no para Windows Server.
Requisitos para macOS
Usa una versión compatible de macOS en un Apple silicon o una Mac Intel. Descarga el instalador correcto para tu tipo de chip. Si no estás seguro de qué Mac tienes, abre Menú Apple > Acerca de esta Mac y verifica la línea del chip o procesador.
Docker Desktop necesita suficiente memoria y espacio en disco para ejecutar una VM Linux y almacenar imágenes. Si planeas ejecutar bases de datos o pilas de múltiples servicios localmente, asigna más memoria a Docker en la configuración después de la instalación.
Instalar Docker Desktop en Windows
Descarga Docker Desktop desde el sitio web oficial de Docker. Evita espejos de descarga de terceros para herramientas de desarrollo.
Ejecuta el instalador .exe y mantén habilitada la opción WSL 2 cuando aparezca. Si el instalador ofrece agregar componentes necesarios de Windows, permítelo. Después de la instalación, reinicia tu computadora si se te solicita.
Abre Docker Desktop desde el menú Inicio. En el primer inicio, acepta los términos de la licencia y deja que Docker termine su configuración. Si Docker reporta un problema con WSL, actualiza WSL e inténtalo de nuevo:
wsl --update
Si usas una laptop corporativa, el software de seguridad de endpoints puede interferir con la virtualización o la red local. En ese caso, verifica la política de Docker Desktop de tu empresa antes de cambiar la configuración del firewall o antivirus.
Instalar Docker Desktop en macOS
Descarga Docker Desktop para Mac desde el sitio web oficial de Docker. Elige el instalador para Apple silicon para Macs con chip M-series y el instalador Intel para Macs Intel.
Abre el archivo .dmg, luego arrastra Docker a la carpeta de Aplicaciones. Inicia Docker desde Aplicaciones. macOS puede solicitar tu contraseña o permiso para instalar componentes auxiliares utilizados para la red y la virtualización.
Cuando Docker Desktop se inicie, espera hasta que el ícono de la barra de menú muestre que Docker está en ejecución. El primer inicio puede tomar más tiempo porque Docker crea su VM local y almacenamiento.
Verificar la instalación
Abre una terminal y verifica el cliente y servidor de Docker:
docker version
Deberías ver tanto una sección de cliente como una sección de servidor. Si solo ves información del cliente o un error sobre la conexión al daemon, Docker Desktop no está en ejecución o no pudo iniciarse.
Ejecuta el contenedor de prueba estándar:
docker run hello-world
Docker descarga una imagen pequeña y la ejecuta. Una ejecución exitosa imprime un mensaje explicando que Docker está funcionando.
También puedes verificar Docker Compose:
docker compose version
Usa el comando docker compose separado por espacios para Compose v2, que está incluido con Docker Desktop.
Ajustar la primera configuración
Abre la configuración de Docker Desktop después de la primera prueba exitosa.
En Windows, verifica Recursos > Integración WSL y habilita la integración para las distribuciones Linux donde ejecutas comandos de desarrollo. Si usas Ubuntu en WSL, esto te permite ejecutar docker desde el shell de Ubuntu.
Tanto en Windows como en macOS, revisa Recursos. Los proyectos pequeños pueden funcionar bien con los valores predeterminados, pero Kubernetes local, bases de datos y compilaciones grandes a menudo necesitan más memoria o espacio en disco.
Habilita Kubernetes solo si necesitas un clúster local de un solo nodo. Dejarlo desactivado mantiene Docker Desktop más ligero.
Problemas comunes de instalación
Si Docker no se inicia en Windows, primero confirma que la virtualización esté habilitada y WSL esté instalado:
wsl --status
Si WSL está desactualizado, ejecuta:
wsl --update
Si docker version no puede conectarse al daemon de Docker, asegúrate de que Docker Desktop esté en ejecución y haya terminado el inicio. En macOS, verifica el ícono de la barra de menú. En Windows, verifica la bandeja del sistema.
Si un contenedor de prueba no puede alcanzar la red, prueba desde una red diferente o estado de VPN. Los clientes VPN y los proxies corporativos a menudo afectan la red de Docker. Docker Desktop tiene configuraciones de proxy que puedes configurar cuando tu entorno lo requiera.
Una vez que docker run hello-world funcione, tu entorno de contenedores local está listo. Un buen siguiente paso es ejecutar un servicio que ya conozcas, como Nginx:
docker run --rm -p 8080:80 nginx
Luego abre http://localhost:8080. Si ves la página de bienvenida de Nginx, Docker puede extraer imágenes, iniciar contenedores y publicar puertos en tu máquina.