Back to Blog
3 min read

A Step-by-Step Guide to Installing Docker Desktop on macOS

Get Docker Desktop running on your Mac. This guide walks you through downloading, installing, and verifying Docker Desktop step by step. Perfect for developers who want to containerize their applications on macOS.

J

Jamie

LogicCore Digital

A Step-by-Step Guide to Installing Docker Desktop on macOS

Docker Desktop is one of those tools that's become essential for modern development. It packages your applications and all their dependencies into containers - think of them as standardized boxes that run the same way everywhere. No more "it works on my machine" headaches. Your app runs the same in development, staging, and production.

On macOS, Docker Desktop gives you a graphical interface on top of the Docker Engine. Instead of managing everything from the command line, you get a dashboard where you can see your containers, images, and volumes at a glance. It's especially handy if you're not a terminal warrior or you want a visual way to manage your Docker workflows.

This guide walks you through getting Docker Desktop installed on macOS from scratch.

What You'll Need

Before we start, make sure your system meets these requirements:

  • macOS Version: Your Mac must be running a compatible version of macOS. Docker typically supports the three most recent major releases. Check the specific supported versions on the official Docker website: Docker Desktop for Mac System Requirements
  • Hardware: Confirm your Mac meets the minimum hardware specifications (processor type - Intel or Apple silicon, RAM). Most Macs from 2010 onwards are generally compatible, but check the system requirements link above for details.
  • Administrator Privileges: You need administrator access on your Mac to install Docker Desktop and grant it necessary permissions.
  • Internet Connection: You'll be downloading Docker Desktop, so a stable connection is essential.

Step 1: Download Docker Desktop

  1. Navigate to Docker Hub: Open your web browser and go to the official Docker Desktop download page: https://www.docker.com/products/docker-desktop/
  2. Select the Correct Version: Choose the download link corresponding to your Mac's processor:
    • Click "Mac with Apple silicon" for M1, M2, M3, or newer chips.
    • Click "Mac with Intel chip" for Macs with Intel processors.
  3. Download the Installer: The appropriate .dmg installer file will begin downloading to your Downloads folder.

Step 2: Install Docker Desktop

  1. Open the Installer: Once the download is complete, locate the Docker.dmg file (usually in your Downloads folder) and double-click it.
  2. Copy to Applications: A window will appear showing the Docker application icon and a shortcut to your Applications folder. Drag the Docker icon and drop it onto the Applications folder alias within that window. This copies the application to your system.
  3. Eject the Installer (Optional): You can eject the Docker virtual disk from the Finder sidebar after the copying is complete.

Step 3: Launch and Authorize Docker Desktop

  1. Launch the Application: Open your Applications folder and find the Docker application. Double-click it to start.
  2. Grant Permissions: The first time you run Docker Desktop, it will require privileged access to install networking components and manage its core engine. You will be prompted to enter your macOS administrator password.
  3. Accept Terms: You may need to review and accept the Docker Subscription Service Agreement.
  4. Wait for Initialization: Docker Desktop will take a few moments to start. You can monitor its status via the whale icon in the macOS menu bar (top-right). The icon animates during startup and becomes stationary when Docker is ready.

Step 4: Verify the Installation

To confirm that Docker Desktop is installed and running correctly, open the Terminal application (Applications > Utilities > Terminal or via Spotlight search):

Run the hello-world Container: Execute the test command:

bash
docker run hello-world

Docker will download a small test image and run it. A message starting with "Hello from Docker!" confirms that your installation is working.

Check Docker Compose Version: Run the command:

bash
docker compose version

This should display the installed Docker Compose version.

Check Docker Version: Run the command:

bash
docker --version

This should display the installed Docker Engine version.

Troubleshooting Common Issues

If you encounter problems, consider these common points:

  • Docker Doesn't Start: Ensure you granted the necessary permissions during the first launch. Try restarting Docker Desktop from the Applications folder or via the menu bar icon. Check the Docker documentation or logs for specific errors.
  • Permission Errors: Running Docker commands might sometimes require specific user permissions, although Docker Desktop generally handles this. Ensure your user account has the necessary rights.
  • Conflicting Software: Virtualization software (like older versions of VirtualBox or VMware) can sometimes interfere. Ensure other virtualization tools are compatible or disabled if issues arise.
  • Check System Requirements: Double-check that your macOS version and hardware still meet the minimum requirements for the installed Docker Desktop version.

You're All Set

That's it! You've got Docker Desktop installed and running on your macOS system. You now have both the powerful Docker Engine for command-line work and the Desktop GUI for visual management. You're ready to start building, running, and managing containers.

Helpful Resources

Want to dive deeper? These official resources are worth bookmarking:

Published on April 21, 2025