Docker en macOS, la versión de esta guía para Mac. Vas a aprender exactamente cómo instalar Docker Desktop, dejarlo andando y verificarlo con un contenedor real, con Docker Compose incluido de fábrica.
Aquí hay una diferencia de fondo con la versión de Ubuntu del martes: los contenedores son tecnología de Linux, así que en Mac siempre corren dentro de una máquina virtual ligera. Docker Desktop empaqueta esa VM, el motor, Compose y una interfaz gráfica en una sola app: es el camino estándar y el que uso en Mac.
El problema típico no es instalar, es entender el modelo: en Mac, Docker funciona solo si la app está abierta (ella es quien mantiene viva la VM). La mitad de los “Docker no me funciona” en Mac son solo eso: la ballena no estaba en la barra de menú.
Vamos a ver:
- Instalar Docker Desktop por dos caminos.
- El primer arranque y qué esperar de él.
- Verificar todo con un contenedor real.
- Los ajustes que valen la pena desde el día uno.
Al final tendrás Docker funcionando y listo para levantar lo que tus proyectos pidan.
Docker Desktop es gratuito para uso personal, educación y empresas pequeñas (menos de 250 empleados y menos de 10 millones de dólares de facturación). Si tu empresa supera eso, necesita suscripción.
Tabla de contenidos
Tabla de contenidos
Paso 1: Instala Docker Desktop
Hay dos caminos y ambos llegan al mismo lugar. Elige el tuyo.
Opción A: desde la terminal con Homebrew
brew install --cask docker-desktopOjo con el nombre: la cask es docker-desktop (la app completa). Un brew install docker sin --cask instala solo el CLI, sin el motor, y es la confusión clásica. Si no tienes Homebrew, empieza por Setup macOS para desarrollo profesional.
Opción B: descarga directa
- Ve a docker.com y descarga Docker Desktop para Mac (detecta tu chip: Apple Silicon o Intel).
- Abre el
.dmgy arrastra Docker a la carpeta Aplicaciones.
Paso 2: Primer arranque
- Abre Docker desde Aplicaciones o Spotlight (
Cmd + Espacio). - Acepta el acuerdo de servicio y dale los permisos que pida (necesita instalar sus componentes de red).
- Espera a que la ballena aparezca en la barra de menú y deje de animarse: esa es la señal de que el motor está listo.
Este es el modelo mental clave en Mac: Docker funciona mientras Docker Desktop esté abierto. Si la ballena no está en la barra de menú, no hay daemon, y la terminal responderá “Cannot connect to the Docker daemon”. Actívale el arranque automático en Settings → General si lo usas a diario.
Paso 3: Verifica con un contenedor real
Con la ballena quieta, a la terminal:
docker --version
docker compose version
docker run hello-worldSi ves el mensaje “Hello from Docker!”, todo el flujo funciona. Y el primer uso real, el mismo del post de Ubuntu: un PostgreSQL descartable sin instalar nada:
docker run --name pg-prueba -e POSTGRES_PASSWORD=secreto -p 5433:5432 -d postgres:18
docker ps
docker stop pg-prueba && docker rm pg-pruebaPaso 4: Ajustes que valen la pena
En Settings (el engranaje de la app), dos ajustes rinden desde el día uno:
- General → Start Docker Desktop when you sign in: si usas Docker a diario, evita el clásico “¿por qué no funciona?” de cada mañana.
- Resources: en Macs con poca RAM, limita la memoria de la VM (4 GB alcanzan para la mayoría del desarrollo web). Es el techo que la VM puede llegar a usar mientras corre.
Solución de problemas comunes
Cannot connect to the Docker daemon
Docker Desktop no está abierto. Ábrelo y espera a que la ballena se quede quieta en la barra de menú.
docker: command not found
El CLI se instala con la app en el primer arranque. Si acabas de instalar, abre Docker Desktop una vez y luego una terminal nueva.
Todo va lento o el ventilador despega
Revisa Settings → Resources: una VM con demasiada memoria o demasiados CPUs asignados compite con tu sistema. Menos suele ser más.
Mantenimiento
Docker Desktop se actualiza solo (te avisa desde la app). Si lo instalaste con Homebrew, también puedes llevarlo con el resto de tus herramientas:
brew upgrade --cask docker-desktopY de vez en cuando, limpia imágenes y contenedores huérfanos:
docker system pruneConclusión
Docker Desktop instalado, el modelo mental claro (la ballena es el motor), Compose incluido y un contenedor verificado de punta a punta. Tu Mac ya levanta los mismos servicios que cualquier servidor Linux.
Si esto te fue útil, el artículo relacionado es el paso lógico: Cómo instalar y configurar Docker en Ubuntu y WSL, la versión de esta guía con Docker Engine nativo.
La próxima semana sigo con la serie: Terraform, para definir infraestructura como código, en ambas plataformas. Si no te lo quieres perder, suscríbete al newsletter en la portada del blog.