Installing Docker Desktop

What is Docker Desktop?

Before diving into installation, let's understand what Docker Desktop is and why it's valuable for developers.

Docker Desktop is an integrated development environment for Docker that runs on your local machine. It provides:

• The Docker Engine (the core containerization technology)
• Docker CLI client for running commands
• Docker Compose for defining and running multi-container applications
• Docker Content Trust for signing images
• Kubernetes, a container orchestration system (optional)
• A graphical user interface for managing containers, images, and volumes

Docker Desktop abstracts away many of the complexities of container management, especially on Windows and macOS where Docker can't run natively (since it depends on Linux kernel features). Docker Desktop sets up a lightweight virtual machine behind the scenes to host the Docker Engine.

System Requirements

Before installation, make sure your system meets the minimum requirements:

Windows Requirements

• Windows 10 64-bit: Home, Pro, Enterprise, or Education (Build 19041 or later)
• Windows 11 64-bit: Home, Pro, Enterprise, or Education
• Hardware:
  • 64-bit processor with Second Level Address Translation (SLAT)
  • 4GB system RAM
  • BIOS-level hardware virtualization support must be enabled
• WSL 2: Windows Subsystem for Linux 2 (recommended method)
• Hyper-V and Containers Windows features: Alternative to WSL 2 for some Windows versions

macOS Requirements

• macOS version: macOS 11 (Big Sur) or newer
• Architecture: Both Intel chips and Apple Silicon (M1/M2) are supported
• RAM: At least 4GB of RAM
• VirtualBox: Prior to version 4.3.30 cannot run concurrently with Docker Desktop

Linux Requirements

• Supported distributions: Ubuntu, Debian, Fedora, Arch, and others
• 64-bit kernel and CPU support for virtualization
• KVM virtualization support
• QEMU must be version 5.2 or newer
• systemd init system
• Gnome, KDE, or MATE desktop environment

Installing Docker Desktop on Windows

The installation process for Windows involves a few key steps to ensure Docker runs properly with either WSL 2 or Hyper-V.

Step 1: Enable Required Windows Features

First, you need to enable either WSL 2 (recommended) or Hyper-V:

Step 2: Download and Install Docker Desktop

1. Download Docker Desktop for Windows from the official Docker website
2. Double-click the installer (.exe) file
3. Follow the installation wizard instructions
   • Accept the terms and conditions
   • Choose whether to use WSL 2 or Hyper-V backend
   • Select additional configuration options
4. Click "Close and restart" when prompted

Step 3: Verify Installation

1. After restart, Docker Desktop should start automatically (look for the Docker icon in the system tray)
2. Open a command prompt or PowerShell window
3. Run the following command to verify Docker is installed and running:

   docker --version
   docker run hello-world

C:\Users\username> docker --version
Docker version 24.0.2, build cb74dfc

C:\Users\username> docker run hello-world
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
719385e32844: Pull complete
Digest: sha256:fc6cf906cbfa013e80938cdf0bb199fbdbb86d6e3e013783e5a766f50f5dbce0
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.
...

Installing Docker Desktop on macOS

Docker Desktop installation on macOS is relatively straightforward, but there are differences between Intel and Apple Silicon (M1/M2) Macs.

Step 1: Download Docker Desktop

1. Visit the Docker Desktop for Mac download page
2. Download the appropriate version:
   • For Intel Macs: Docker Desktop for Mac with Intel Chip
   • For M1/M2 Macs: Docker Desktop for Mac with Apple Silicon

Step 2: Install Docker Desktop

1. Open the downloaded .dmg file
2. Drag the Docker icon to the Applications folder
3. Open Docker from your Applications folder
4. You may be prompted to provide administrator permissions
5. The Docker menu icon will appear in the status bar when Docker Desktop is running

Step 3: Verify Installation

1. Open Terminal
2. Run the following commands to verify Docker is installed and running:

   docker --version
   docker run hello-world

$ docker --version
Docker version 24.0.2, build cb74dfc

$ docker run hello-world
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
719385e32844: Pull complete
Digest: sha256:fc6cf906cbfa013e80938cdf0bb199fbdbb86d6e3e013783e5a766f50f5dbce0
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.
...

Installing Docker Desktop on Linux

Docker Desktop for Linux is relatively new compared to Windows and macOS versions. Many Linux users traditionally used the standalone Docker Engine, but Docker Desktop provides a more consistent experience across platforms.

Step 1: Set up Docker's Repository

These instructions are for Ubuntu, but similar steps apply for other distributions.

1. Update your package index:

   sudo apt-get update

2. Install required packages:

   sudo apt-get install ca-certificates curl gnupg

3. Add Docker's official GPG 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 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

Step 2: Download and Install Docker Desktop

1. Download Docker Desktop for your Linux distribution from the Docker Desktop for Linux page
2. For Debian-based distributions like Ubuntu, install with:

   sudo apt-get update
   sudo apt-get install ./docker-desktop-<version>-<arch>.deb

3. For RPM-based distributions like Fedora:

   sudo dnf install ./docker-desktop-<version>-<arch>.rpm

4. Start Docker Desktop:

   systemctl --user start docker-desktop

Step 3: Verify Installation

1. Open a terminal
2. Run the following commands to verify Docker is installed and running:

   docker --version
   docker run hello-world

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Docker Desktop Configuration

After installing Docker Desktop, it's important to configure it according to your needs. The configuration options are largely the same across all platforms, accessible through the Docker Desktop application.

Essential Configuration Options

1. Resources:
   • CPU allocation - How many CPU cores Docker can use
   • Memory - How much RAM to allocate (2GB minimum recommended)
   • Disk image size - Maximum size of Docker's virtual disk
   • Swap - Additional virtual memory
2. File sharing / Resources > File sharing:
   • Configure which directories can be mounted into containers
   • Essential for mounting source code and other local files
3. Network:
   • Port mapping - Which ports can be published to the host
   • VPN and proxy settings
4. Docker Engine:
   • Advanced configuration via a JSON file
   • Allows customizing daemon options
5. Kubernetes:
   • Enable/disable Kubernetes
   • Configure Kubernetes options

{
  "registry-mirrors": [
    "https://mirror.gcr.io"
  ],
  "insecure-registries": [
    "registry.local:5000"
  ],
  "experimental": false,
  "features": {
    "buildkit": true
  }
}

Docker Desktop vs. Docker Engine

It's important to understand the distinction between Docker Desktop and Docker Engine, especially for those who might be transitioning between different systems.

For most development purposes, especially when learning Docker, Docker Desktop is recommended for its ease of use and integrated tools. However, understanding the underlying Docker Engine becomes important when working with production environments or Linux servers.

Docker Desktop Components

Docker Desktop includes several key components that work together to provide a comprehensive development environment:

Core Components

• Docker Engine: The core containerization technology
• Docker CLI: Command-line interface for interacting with Docker
• Docker Compose: Tool for defining and running multi-container applications
• Docker Content Trust: Security feature for signing and verifying images
• Docker BuildKit: Next-generation image builder with improved performance
• Docker Desktop Dashboard: GUI for managing containers, images, and volumes

Optional Components

• Kubernetes: Container orchestration system for managing containerized applications
• Dev Environments: Feature to quickly spin up development environments from Git repositories
• Extensions: Plugins that extend Docker Desktop functionality

┌─────────────────────────────────────────────────┐
│              Docker Desktop Application           │
│                                                   │
│  ┌─────────────┐  ┌─────────────┐  ┌───────────┐ │
│  │  Dashboard  │  │ Kubernetes  │  │Extensions │ │
│  └─────────────┘  └─────────────┘  └───────────┘ │
│                                                   │
│  ┌─────────────────────────────────────────────┐ │
│  │           Virtualization Layer              │ │
│  │      (WSL2/Hyper-V/HyperKit/KVM)           │ │
│  └─────────────────────────────────────────────┘ │
│                                                   │
│  ┌───────────┐ ┌────────────┐ ┌────────────────┐ │
│  │   Docker  │ │   Docker   │ │     Docker     │ │
│  │   Engine  │ │  Compose   │ │    BuildKit    │ │
│  └───────────┘ └────────────┘ └────────────────┘ │
└─────────────────────────────────────────────────┘

Understanding these components helps you make the most of Docker Desktop and troubleshoot issues when they arise.

Docker Desktop Licensing

It's important to be aware of Docker's licensing terms, which have changed in recent years:

Current Licensing Structure

• Personal Use: Free for individual developers, educational use, non-commercial open-source projects, and small businesses (fewer than 250 employees AND less than $10 million in annual revenue)
• Professional Use: Requires a paid subscription for larger businesses
• Docker Engine: Remains free and open-source under the Apache 2.0 license

For this course and most personal projects, the free personal license will be sufficient. However, it's good to be aware of the licensing requirements if you plan to use Docker in a professional or enterprise setting.

Docker in the Development Workflow

Now that you have Docker Desktop installed, let's briefly explore how it fits into a typical development workflow:

Basic Development Workflow with Docker

1. Create a Dockerfile - Define your application environment
2. Build an image - Package your application and dependencies
3. Run containers - Test your application in isolation
4. Use Docker Compose - Coordinate multiple services (e.g., web app, database)
5. Iterate rapidly - Make changes and rebuild as needed
6. Share images - Push to a registry for collaboration or deployment

This workflow allows you to develop in an environment that's identical to production, eliminating "works on my machine" problems and making collaboration easier.

Testing Your Docker Installation

Let's verify that Docker is working correctly by running a few basic commands:

Basic Verification Commands

docker --version
docker info
docker run hello-world

More Comprehensive Test

Let's run a more interactive container to ensure everything is working properly:

docker run -it --rm ubuntu bash

This command runs an Ubuntu container and gives you a bash shell inside it. You can run commands like:

ls -la
apt-get update
echo "Docker is working!"
exit

The container will be automatically removed when you exit (due to the --rm flag).

Testing Docker Compose

docker-compose --version

If all these commands work without errors, your Docker installation is functioning correctly!

Troubleshooting Common Installation Issues

Even with a straightforward installation process, you might encounter some issues. Here are solutions to common problems:

General Issues

• Docker Desktop won't start:
  • Check system requirements
  • Look for error messages in the logs
  • Reinstall Docker Desktop
• "Cannot connect to the Docker daemon":
  • Make sure Docker Desktop is running
  • Check if the Docker service is running
  • On Linux, verify your user is in the docker group
• Performance issues:
  • Increase CPU and memory allocation in Docker Desktop settings
  • Close unnecessary applications to free up resources
  • On Windows, make sure WSL 2 is properly configured

Windows-Specific Issues

• WSL 2 not working:
  • Make sure your Windows version supports WSL 2
  • Run wsl --update to ensure you have the latest version
  • Check if virtualization is enabled in BIOS
• Hyper-V conflicts:
  • Disable other virtualization software (VirtualBox, VMware)
  • Make sure Hyper-V is properly enabled

macOS-Specific Issues

• File sharing issues:
  • Grant Docker permission to the directories you need to share
  • Check for firewall or security software blocking access
• Performance on Apple Silicon:
  • Use ARM64 images when possible for better performance
  • Increase resource allocation for emulated x86_64 containers

Linux-Specific Issues

• Permission denied errors:
  • Add your user to the docker group:

    sudo usermod -aG docker $USER
    newgrp docker

• Desktop integration issues:
  • Make sure you're using a supported desktop environment (GNOME, KDE, MATE)
  • Install required system dependencies

Docker Desktop Alternatives

While Docker Desktop is the recommended solution for most developers, it's worth knowing about alternatives:

Alternative Container Solutions

• Podman: Daemonless container engine compatible with Docker commands
• Rancher Desktop: Open-source desktop application for container management
• Lima: Linux virtual machines for macOS with automatic file sharing
• Minikube: Primarily for Kubernetes but can be used for basic container operations
• Direct Docker Engine installation: On Linux, using Docker without the Desktop app

For this course, we'll focus on Docker Desktop as it provides the most consistent experience across all platforms and has the best integration with development workflows.

Key Takeaways

• Docker Desktop provides a complete development environment for containerized applications
• Installation procedures vary by operating system, with Windows requiring additional setup for WSL 2 or Hyper-V
• Resource allocation is important for performance - allocate enough CPU, memory, and disk space
• The basic workflow involves creating Dockerfiles, building images, and running containers
• Docker Desktop includes many integrated tools like Docker Compose and Kubernetes
• Common issues can usually be resolved by checking system requirements, permissions, and virtualization settings

With Docker Desktop successfully installed, you're ready to start building, running, and sharing containerized applications!

Looking Ahead

In our afternoon session, we'll dive into using Docker with practical examples. We'll cover:

• Running your first container
• Exploring Docker Hub and public images
• Creating a basic Dockerfile
• Building and running your own image

Make sure your Docker Desktop installation is working correctly before the afternoon session.

Discussion Questions

1. What challenges do you anticipate in incorporating Docker into your development workflow?
2. How might Docker Desktop improve collaboration among developers with different operating systems?
3. What kind of applications do you think would benefit most from containerization?
4. What are the security implications of running Docker on your development machine?
5. How does the resource allocation for Docker Desktop impact your system, and how would you optimize it?

Additional Resources

• Docker Desktop Documentation - Official docs with detailed installation instructions
• Docker Get Started Guide - Tutorial for beginners after installation
• Windows Subsystem for Linux Documentation - Detailed WSL 2 setup
• Docker Desktop Troubleshooting Guide - Solutions to common problems
• Awesome Docker Compose - Example compose files for various applications