To install Docker on macOS, download Docker Desktop for Mac from the official Docker website and drag the application into your Applications folder, then launch it and follow the prompts. This guide covers the full installation process, system requirements, common issues, and alternatives for running containers on a Mac.
What Docker Does and Why Mac Users Need It
Docker lets you run software in isolated environments called containers. A container packages an application with all its dependencies—libraries, configuration files, and runtime—so it runs the same way on any machine. For developers, this eliminates the classic “works on my machine” problem. On macOS, Docker doesn’t run natively because macOS uses a different kernel than Linux, the operating system containers are built for. Instead, Docker Desktop on Mac runs a lightweight Linux virtual machine (VM) using Apple’s Virtualization framework or HyperKit, and manages containers inside that VM. This means you get full Linux container support on your Mac, but with some performance overhead compared to running Docker on a Linux host.
System Requirements for Docker Desktop on Mac
Before installing, check that your Mac meets the minimum requirements. Docker Desktop requires macOS 11 (Big Sur) or newer, and Apple Silicon (M1/M2/M3) or Intel chips. On Apple Silicon, Docker Desktop runs ARM64 containers natively, and can run x86_64 containers via emulation. You’ll also need at least 4 GB of RAM (8 GB recommended), and about 2 GB of disk space for the application itself, plus space for images and containers. If you’re on an older macOS version, you may need to use an older Docker Desktop release or consider alternatives like Podman or colima.
Step-by-Step Installation Instructions
- Download Docker Desktop: Go to Docker’s official site and click “Download for Mac”. You’ll be asked to create a Docker Hub account (free) or you can skip that step.
- Install the app: Once the DMG file downloads, open it and drag the Docker icon into your Applications folder.
- Launch Docker: Open Docker from Applications. You may see a security prompt asking if you’re sure you want to open it—click “Open”.
- Accept the terms: On first launch, Docker Desktop asks you to accept its service agreement. Read and accept it.
- Choose your settings: You can adjust resources (CPU, memory, disk) in Preferences if needed, but the defaults work for most users.
- Verify installation: Open Terminal and run
docker --versionto see the installed version. Then rundocker run hello-worldto test that everything works.
That’s it. Docker Desktop starts automatically when you log in, and you can manage it from the menu bar icon.
Understanding the Architecture: Linux VM on Mac
When you run Docker on macOS, you’re not running containers directly on macOS. Instead, Docker Desktop creates a small Linux VM (using a tuned version of Alpine Linux) that runs in the background. The docker CLI on your Mac communicates with the Docker daemon inside that VM. This is why Docker on Mac sometimes feels slower than on Linux—there’s an extra layer. On Apple Silicon, the VM is optimized for ARM, but if you pull an x86_64 image, Docker uses Rosetta 2 emulation to run it, which can be slower. To get the best performance, prefer ARM64 images when available.
Common Problems and How to Fix Them
- Docker Desktop won’t start: Check that your Mac meets the system requirements and that virtualization is enabled. On Intel Macs, ensure “Virtualization” is allowed in System Settings > Privacy & Security.
- “Cannot connect to the Docker daemon”: This usually means Docker Desktop isn’t running. Launch it from Applications and wait for the whale icon to stop animating.
- Out of disk space: Docker images and containers can eat up disk. Use
docker system pruneto clean up unused data, and adjust the disk image size in Docker Desktop Preferences. - Permission denied: If you see “permission denied” when running docker commands, your user isn’t in the
dockergroup. Docker Desktop usually adds this, but you can add yourself withsudo dseditgroup -o edit -a $(whoami) -t user dockerand then log out/in. - Slow performance: On Intel Macs, Docker Desktop can be sluggish. Try increasing CPU and memory in Preferences, or switch to a lighter-weight alternative like colima.
If you encounter an error you can’t fix, Docker’s official documentation and forums are good resources, but be careful about following advice from random blog posts—some may be outdated.
Docker Desktop vs. Alternatives (Podman, Colima, OrbStack)
Docker Desktop is the most popular choice because it’s official and integrates well with Docker Hub. However, it’s not the only option. Podman is a daemonless container engine that can run on macOS without a VM, but it requires a VM to run Linux containers (via podman machine). Colima is a lightweight open-source alternative that uses Lima to run a Linux VM and works with the standard Docker CLI. OrbStack is a newer, faster alternative that’s designed specifically for macOS and is free for personal use. If you’re concerned about Docker Desktop’s licensing (it’s free for small businesses and personal use, but larger companies need a paid plan), or if you want something lighter, these are worth trying. For most users, Docker Desktop is the easiest path because it’s the most documented and supported.
Cost and Licensing Considerations
Docker Desktop is free for personal use, education, and small businesses (under 250 employees and under $10 million in annual revenue). Larger companies must purchase a paid subscription. The free tier includes all core features, but some advanced features like security scanning and SSO are reserved for paid plans. If you’re a student or hobbyist, you can use Docker Desktop without paying. If you’re in a large company, you may need to budget for a subscription or consider using a free alternative like Podman or colima to avoid licensing fees.
Frequently Asked Questions
Do I need to install a Linux VM separately?
No. Docker Desktop includes its own VM and manages it automatically. You don’t need to install VirtualBox or any other virtualization software.
Can I use Docker without Docker Desktop?
Yes, you can install the Docker CLI and use a third-party VM manager like colima or podman machine. This is a good option if you prefer open-source tools or need to avoid Docker’s licensing.
Will Docker Desktop slow down my Mac?
It uses some CPU and memory, especially when containers are running. You can limit resources in Preferences. On Apple Silicon, it’s generally efficient, but on older Intel Macs, you might notice a hit.
How do I uninstall Docker Desktop?
Move Docker.app to Trash, and also remove the Docker data directory at ~/Library/Containers/com.docker.docker and ~/Library/Group Containers/group.com.docker if you want to completely clean up.
Why do I get “no matching manifest for linux/arm64” when pulling an image?
This happens when a Docker image doesn’t have an ARM64 version. Docker Desktop can emulate x86_64, but you need to enable it in Preferences > General > “Use Rosetta for x86_64/amd64 emulation on Apple Silicon”.
Can I run Docker on macOS Big Sur (11)?
Yes, Docker Desktop supports Big Sur, but some newer versions may require a newer macOS. Check the release notes for the specific version you install.
Related
General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.
More in this bed
- Fix OneNote App Not Working on Android
- Move Games to SSD Without Reinstalling
- Move Windows 11 Taskbar to Top or Side: Easy Steps
- Windows 11 Calendar Wrong Day? Fix It Here
- How to Use curl Command in Linux
- Install ChromeOS: Convert Laptop to Chromebook