Installing Docker on Windows, Linux, and macOS

# CHAPTER 2

Installing Docker on Windows, Linux, and macOS #

1. Introduction #

2. Learning Objectives #

• Understand the system requirements for running Docker.

• Install Docker Desktop on Windows (using WSL2).

• Install Docker Desktop on macOS (Intel and Apple Silicon).

• Install the native Docker Engine on a Linux distribution.

• Verify your installation using the Docker CLI.

3. Beginner-Friendly Explanation #

• Linux: Docker was built natively for Linux. Installing Docker on Linux is like plugging a PlayStation directly into a TV. It is native, direct, and highly efficient.

• Windows and Mac: Because Docker requires Linux features to run, Windows and Mac cannot run it natively. When you install "Docker Desktop" on a Mac or Windows PC, Docker secretly installs a tiny, invisible Linux machine in the background. It acts as an adapter, allowing your Mac/Windows computer to play Linux container "games" flawlessly.

4. Docker Desktop vs. Docker Engine #

• Docker Desktop: A massive, all-in-one GUI (Graphical User Interface) application for Mac and Windows. It includes the Docker Daemon, the Docker CLI, Docker Compose, and a visual dashboard to click and view your containers.

• Docker Engine: The raw, command-line-only version of Docker, traditionally installed on Linux servers in production environments. It has no graphical interface.

5. Installing on Windows (The WSL2 Requirement) #

1. 1. Download Docker Desktop for Windows from the official Docker website.

1. 2. Run the installer. Ensure the box "Use WSL 2 instead of Hyper-V" is checked!

1. 3. Restart your computer.

1. 4. When Docker Desktop launches, it may prompt you to install a WSL2 kernel update from Microsoft. Follow the link provided, install the small update, and click Restart in Docker Desktop.

6. Installing on macOS #

1. 1. Download Docker Desktop for Mac (Choose the correct chip version: Intel or Apple Silicon).

1. 2. Open the .dmg file and drag the Docker icon into your Applications folder.

1. 3. Open Docker from your Applications. It will ask for permission to install networking components (requires your Mac password).

1. 4. Look at the top menu bar of your Mac. You will see a small "Whale" icon. When the whale stops animating, Docker is running!

7. Installing on Linux (Ubuntu Example) #

# 1. Update your package lists
sudo apt-get update

# 2. Install prerequisites
sudo apt-get install ca-certificates curl gnupg

# 3. Add Docker's official GPG encryption key
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# 4. Set up the Docker repository
echo "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 5. Install Docker Engine
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

8. Mini Project: Verify Your Docker Installation #

Step-by-Step Tutorial:

1. 1. Open your Terminal (Mac/Linux) or PowerShell/Command Prompt (Windows).

1. 2. Type the following command to check the version:

docker --version

*(You should see something like: Docker version 24.0.5, build ced3990)*

1. 3. Now, let's run the universal Docker test:

docker run hello-world

1. 4. Docker will download a tiny test image, run it, print a welcoming message to your screen ("Hello from Docker!"), and immediately shut the container down. Your installation is perfect!

9. Real-World Scenarios #

10. Best Practices #

• Linux Post-Installation (The sudo Problem): By default, on Linux, you must type sudo docker run... every single time. To fix this, you must add your user to the docker group. Run: sudo usermod -aG docker $USER. Then log out and log back in. You can now run Docker commands without sudo.

11. Common Mistakes #

• Hardware Virtualization Disabled: On Windows, if Docker Desktop refuses to start and gives a "Virtualization must be enabled" error, you must restart your physical computer, enter your motherboard's BIOS settings, and turn on CPU Virtualization (Intel VT-x or AMD-V).

12. Exercises #

1. 1. What is the fundamental difference between Docker Desktop and the Docker Engine?

1. 2. Why does Windows require WSL2 (Windows Subsystem for Linux) to run Docker efficiently?

13. FAQs #

14. Interview Questions #

• Q: Explain how Docker achieves cross-platform compatibility. How can a container built for Linux run on a macOS laptop?

• Q: Describe the purpose of the hello-world Docker image. What background processes occur when you execute docker run hello-world for the very first time?

15. Summary #

16. Next Chapter Recommendation #