Step-by-Step Guide: Installing Docker Desktop on Windows and macOS

Docker Desktop is the usual starting point when you want to run containers on a Windows or macOS laptop. The install is simple, but a few system settings can block Docker from starting after the installer finishes.

This guide walks you through installing Docker Desktop on Windows and macOS, then verifies that the Docker CLI, Docker Engine, and a test container work correctly.

What Docker Desktop Installs

Docker Desktop gives you a local Docker environment with the Docker CLI, Docker Engine, Docker Compose, a desktop dashboard, and optional Kubernetes support. On Windows, Docker Desktop normally runs Linux containers through WSL 2. On macOS, it runs containers inside a lightweight Linux virtual machine.

For day-to-day development, that means you can run commands such as:

docker run hello-world
docker compose up
docker build -t my-app .

You do not need to install a separate Docker Engine package first.

Check the Requirements First

Docker changes platform requirements over time, so check Docker's current documentation before installing on older machines. In most current setups, you should confirm these basics.

Windows Requirements

Use a supported 64-bit Windows edition and keep Windows updated. Docker Desktop works best with the WSL 2 backend, so install WSL before or during setup:

wsl --install

Run that command from an elevated PowerShell or Command Prompt, then restart if Windows asks you to.

Also check hardware virtualization. Open Task Manager, go to Performance, select CPU, and look for Virtualization: Enabled. If it is disabled, turn it on in your BIOS or UEFI settings.

Docker Desktop is for desktop Windows environments, not Windows Server.

macOS Requirements

Use a supported macOS release on either Apple silicon or an Intel Mac. Download the correct installer for your chip type. If you are not sure which Mac you have, open Apple menu > About This Mac and check the chip or processor line.

Docker Desktop needs enough memory and disk space to run a Linux VM and store images. If you plan to run databases or multi-service stacks locally, give Docker more memory in settings after installation.

Install Docker Desktop on Windows

Download Docker Desktop from Docker's official website. Avoid third-party download mirrors for developer tooling.

Run the .exe installer and keep the WSL 2 option enabled when it appears. If the installer offers to add required Windows components, allow it. After installation, restart your computer if prompted.

Open Docker Desktop from the Start menu. On first launch, accept the license terms and let Docker finish its setup. If Docker reports a WSL problem, update WSL and try again:

wsl --update

If you use a corporate laptop, endpoint security software can interfere with virtualization or local networking. In that case, check your company's Docker Desktop policy before changing firewall or antivirus settings.

Install Docker Desktop on macOS

Download Docker Desktop for Mac from Docker's official website. Choose the Apple silicon installer for M-series Macs and the Intel installer for Intel Macs.

Open the .dmg file, then drag Docker into the Applications folder. Launch Docker from Applications. macOS may ask for your password or permission to install helper components used for networking and virtualization.

When Docker Desktop starts, wait until the menu bar icon shows that Docker is running. The first start can take longer because Docker creates its local VM and storage.

Verify the Installation

Open a terminal and check the Docker client and server:

docker version

You should see both a client section and a server section. If you only see client information or an error about connecting to the daemon, Docker Desktop is not running yet or failed to start.

Run the standard test container:

docker run hello-world

Docker downloads a small image and runs it. A successful run prints a message explaining that Docker is working.

You can also check Docker Compose:

docker compose version

Use the space-separated docker compose command for Compose v2, which is included with Docker Desktop.

Adjust the First Settings

Open Docker Desktop settings after the first successful test.

On Windows, check Resources > WSL Integration and enable integration for the Linux distributions where you run development commands. If you use Ubuntu in WSL, this lets you run docker from the Ubuntu shell.

On both Windows and macOS, review Resources. Small projects may run fine with the defaults, but local Kubernetes, databases, and large builds often need more memory or disk space.

Enable Kubernetes only if you need a local single-node cluster. Leaving it off keeps Docker Desktop lighter.

Common Installation Problems

If Docker does not start on Windows, first confirm virtualization is enabled and WSL is installed:

wsl --status

If WSL is outdated, run:

wsl --update

If docker version cannot connect to the Docker daemon, make sure Docker Desktop is running and has finished startup. On macOS, check the menu bar icon. On Windows, check the system tray.

If a test container cannot reach the network, test from a different network or VPN state. VPN clients and corporate proxies often affect Docker networking. Docker Desktop has proxy settings you can configure when your environment requires them.

Once docker run hello-world works, your local container environment is ready. A good next step is to run one service you already know, such as Nginx:

docker run --rm -p 8080:80 nginx

Then open http://localhost:8080. If you see the Nginx welcome page, Docker can pull images, start containers, and publish ports on your machine.