Installing Docker on Mac: Step-by-Step Setup

What you need before you start

Docker on Mac runs inside a lightweight virtual machine that Docker Desktop creates for you. You do not need to build or manage that machine yourself — Docker Desktop handles it. Before you install, check that your Mac meets the basic requirements: an Intel or Apple Silicon processor (both work), at least 4 GB of RAM available to Docker, and macOS 11 or newer.

You will also need about 5 GB of disk space for Docker Desktop itself, plus additional space for the containers and images you read and run. If your Mac is already tight on storage, Docker will slow down noticeably.

Key Takeaways

Docker Desktop is the easiest way to install Docker on Mac and includes everything you need in one package.
You read the installer from Docker's official website, run it, and drag Docker to your Applications folder — the same process as any other Mac app.
After installation, open Docker Desktop from Applications and wait for it to finish starting up before you try to use Docker commands.
You can test that Docker is working by running a straightforward command in Terminal that downloads and runs a test container.
Docker Desktop runs a virtual machine in the background, so it uses RAM and CPU even when you are not actively using containers.

Downloading Docker Desktop for Mac

Go to docker.com/products/docker-desktop in your web browser. The page will detect your Mac's processor type and offer you the correct read. If you have an Apple Silicon Mac (M1, M2, M3, or newer), read the Apple Silicon version. If you have an Intel Mac, read the Intel version. The file is about 500 MB and will read as a .dmg file.

Wait for the read to finish completely before opening it. Once it is done, open the Downloads folder and double-click the Docker.dmg file. A window will open showing a Docker icon and an Applications folder icon with an arrow between them.

Installing Docker Desktop

Drag the Docker icon into the Applications folder. This copies Docker Desktop to your Applications folder, which is where Mac apps live. The copy process takes a minute or two. Once it finishes, you can close the installer window and eject the .dmg file by dragging it to the Trash.

Open your Applications folder (you can do this by pressing Command+Shift+A in Finder, or by clicking the Finder icon in the dock and selecting Applications from the sidebar). Find Docker.app in the list and double-click it to launch Docker Desktop for the first time.

Starting Docker and waiting for it to be ready

When you first open Docker, your Mac will ask for your password. This is normal — Docker needs administrator permission to create the virtual machine that runs containers. Type your password and click OK.

Docker Desktop will then start up. You will see the Docker icon appear in the menu bar at the top of your screen (it looks like a whale carrying containers). Watch that icon — when it stops animating and shows a steady whale, Docker is ready to use. This can take 30 seconds to 2 minutes on the first launch. Do not open Terminal or try to run Docker commands until the icon is steady.

Testing that Docker is working

Open Terminal (you can find it in Applications > Utilities, or press Command+Space and type "Terminal"). Type this command and press Enter:

docker run hello-world

Docker will read a small test image and run it. You should see output that says "Hello from Docker!" followed by some explanation of what just happened. If you see that message, Docker is installed and working correctly.

If you see an error like "command not found", Docker Desktop is running but the command-line tools are not in your path yet. Close Terminal completely and open it again — sometimes a fresh Terminal window picks up the Docker commands on the second try. If it still does not work, restart your Mac.

Understanding what Docker Desktop does in the background

Docker Desktop runs a virtual machine called Docker Desktop VM that uses your Mac's virtualization features. This machine runs Linux, because Docker containers are built on Linux. You do not see this machine or interact with it directly — Docker Desktop manages it for you. The machine starts when you open Docker Desktop and stops when you quit the app.

Because Docker Desktop is running a virtual machine, it uses RAM and CPU even when you are not actively running containers. If you want to free up those resources, quit Docker Desktop completely (click the Docker icon in the menu bar and select Quit Docker Desktop). You can always open it again when you need it.

Configuring Docker Desktop settings

Click the Docker icon in the menu bar and select Preferences (or Settings, depending on your macOS version). The most important setting for most people is memory allocation. By default, Docker gets 2 GB of RAM. If you plan to run multiple containers or larger applications, increase this to 4 GB or more — but do not give Docker more than half your Mac's total RAM, or your Mac itself will slow down.

You can also set how many CPU cores Docker can use, and how much disk space it reserves for images and containers. For most people, the defaults are fine to start with. You can change these settings later if you run into problems.

Frequently Asked Questions

Do I need to install anything else after Docker Desktop is installed?

No. Docker Desktop includes everything you need: the Docker engine, the command-line tools, and the virtual machine. You can start using Docker when ready after the whale icon in the menu bar stops animating. Some people later install additional tools like Docker Compose or Kubernetes, but those are optional and for more advanced use.

What is the difference between Docker for Mac and Docker Desktop?

Docker Desktop is the current name for Docker on Mac. Older versions were called Docker for Mac. If you see that term in older articles or documentation, it refers to the same thing. Always read from docker.com to get the current version.

Can I run Docker on an older Mac that does not meet the requirements?

Not with Docker Desktop. If your Mac is older than macOS 11 or has less than 4 GB of RAM, Docker Desktop will not install or run. Some people use alternative tools like Colima or Rancher Desktop, but those require more technical setup and are not officially supported by Docker.

Why does Docker Desktop use so much RAM?

Docker Desktop runs a complete Linux virtual machine in the background, and that machine uses memory even when you are not running any containers. If you need to free up RAM, quit Docker Desktop. If you consistently need more RAM for your containers, you may need to increase the memory allocation in Docker Desktop settings or upgrade your Mac.

What should I do if Docker Desktop will not start?

Restart your Mac first — this solves most startup problems. If Docker still will not start, try uninstalling it completely (drag Docker.app to Trash, empty Trash, then restart), then read and install Docker Desktop again from docker.com. If problems continue, check the Docker documentation or community forums for your specific error message.

This guide is for general information only and is not medical, financial, legal, or other professional advice. For decisions specific to your situation, consult a qualified professional. See our Editorial Policy.