How to Install Docker (Mac • Windows • Linux)

macOS

Docker Desktop (recommended)

brew install --cask docker   # or download Docker Desktop DMG
open -a Docker               # start it once to initialize
docker --version

Sanity test (first pull is ~tens of MB):

docker run --rm hello-world

Windows

Docker Desktop (WSL 2 backend)

1. Ensure WSL 2 is on:

wsl --install

2. Install Docker Desktop:

winget install -e --id Docker.DockerDesktop

3. Launch Docker Desktop → Settings → Use WSL 2 based engine (default).
4. Test:

docker --version
docker run --rm hello-world

If corporate policy blocks Docker Desktop, alternatives: Rancher Desktop or Podman Desktop (works with this repo; commands are nearly identical).

Linux

Docker Engine (quick path)

• Debian/Ubuntu

  sudo apt update
  sudo apt install -y docker.io
  sudo systemctl enable --now docker
  sudo usermod -aG docker $USER   # then log out/in or run: newgrp docker
  docker --version
  docker run --rm hello-world
  

• Fedora

  sudo dnf install -y docker
  sudo systemctl enable --now docker
  sudo usermod -aG docker $USER
  docker --version
  docker run --rm hello-world