How to Install Docker: A Step-by-Step Guide for All OS

Understanding Docker: Why You Need It in 2026

What is Docker?

Docker is an open‑source platform that packages applications and their dependencies into lightweight, portable containers. Each container runs the same way on any host that supports Docker, eliminating “it works on my machine” problems.

The Difference Between Virtual Machines and Containers

Virtual machines (VMs) emulate entire hardware stacks, including a guest operating system. Containers share the host kernel and isolate processes at the user‑space level. Because containers avoid the overhead of a full OS, they start in seconds and use a fraction of the memory that a comparable VM requires.

Key Benefits for Modern Developers

• Speed: Build, ship, and run code in seconds.
• Consistency: Identical runtime from local laptop to cloud production.
• Scalability: Orchestrators like Kubernetes treat containers as first‑class citizens.
• Security: Isolation limits blast radius of a compromised component.

System Prerequisites and Hardware Requirements

Minimum Hardware Specifications

Docker runs comfortably on most modern laptops and desktops. As of 2026, the recommended baseline is:

• CPU: 2‑core x86_64 or ARM64 processor with VT‑x/AMD‑V support.
• RAM: 4 GB minimum; 8 GB or more for multi‑container workloads.
• Disk: 10 GB free SSD space for Docker Desktop and image caches.

BIOS/UEFI Virtualization Settings

Docker relies on hardware‑assisted virtualization. Before installing, verify that the virtualization feature is enabled:

1. Reboot the machine and enter BIOS/UEFI (usually F2, Delete, or Esc).
2. Locate the setting named Intel VT‑x, AMD‑V, or Virtualization Technology.
3. Set it to Enabled and save changes.

OS Compatibility Check

Docker Desktop officially supports the following operating systems in 2026:

• Windows 11 (64‑bit) – requires WSL 2.
• macOS 14 (Sonoma) – both Intel and Apple Silicon (M2‑M3).
• Linux distributions – Ubuntu 22.04 LTS, Debian 12, CentOS Stream 9, and Fedora 40.

How to Set Up Docker on Different Operating Systems

Installing Docker Desktop on Windows (WSL 2 Method)

1. Open PowerShell as Administrator and enable the required Windows features:

   powershell
   dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
   dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

2. Download the latest Docker Desktop installer for Windows from the official site (Docker Desktop Installer.exe).
3. Run the installer, accept the license, and keep the default options (install WSL 2 integration).
4. After installation, launch Docker Desktop. The first start may trigger a short download of the Linux kernel update – let it finish.
5. Open a new PowerShell window and confirm the Docker CLI works:

   docker version

Setting Up Docker on macOS (Intel & Apple Silicon)

1. Visit the Docker Desktop for Mac download page and select the appropriate build:
   • Intel x86_64 – Docker.dmg
   • Apple Silicon (M1/M2) – Docker.dmg (universal binary).
2. Open the .dmg, drag the Docker icon into Applications, and double‑click to start.
3. macOS will ask for privileged access to install networking components; click OK and enter your admin password.
4. When Docker Desktop launches, it automatically configures the default VM (hyperkit on Intel, Apple Virtualization Framework on Silicon).
5. Verify the installation:

   docker run --rm hello-world

Installing Docker Engine on Linux (Ubuntu/Debian/CentOS)

These steps use the official Docker repositories, which receive security updates faster than distribution packages.

Ubuntu & Debian

1. Update the package index and install prerequisite packages:

   sudo apt-get update
   sudo apt-get install -y ca-certificates curl gnupg lsb-release

2. Add Docker’s official GPG key and repository:

   curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
   echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

3. Install Docker Engine:

   sudo apt-get update
   sudo apt-get install -y docker-ce docker-ce-cli containerd.io

4. Add your user to the docker group to avoid sudo on each command:

   sudo usermod -aG docker $USER
   newgrp docker

5. Test the engine:

   docker run --rm hello-world

CentOS Stream / RHEL

1. Install required utilities:

   sudo dnf install -y yum-utils device-mapper-persistent-data lvm2

2. Set up the Docker repository:

   sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

3. Install Docker Engine:

   sudo dnf install -y docker-ce docker-ce-cli containerd.io

4. Enable and start the daemon:

   sudo systemctl enable --now docker

5. Verify with the hello‑world image as above.

Post-Installation: Verifying Your Setup

Running Your First “Hello World” Container

The official hello-world image confirms that the client can talk to the daemon and that the container runtime works.

docker run --rm hello-world

You should see a friendly message ending with “Hello from Docker!” If you get an error, revisit the troubleshooting section.

Checking Docker Version and Status

docker version
docker info

docker version prints client and server version numbers; Docker Desktop reports the same for macOS/Windows. docker info displays system‑wide details such as total CPUs, memory, and storage driver.

Configuring Docker Hub Authentication

Logging into Docker Hub lets you pull private images and push your own builds.

docker login
# Enter Docker Hub username, password, and optional 2FA code.

Credentials are stored in ~/.docker/config.json (Linux/macOS) or %USERPROFILE%\.docker\config.json (Windows).

Docker Best Practices for Optimal Performance

Managing Resource Allocation (CPU & RAM)

Docker Desktop includes a GUI slider for CPUs, memory, and swap. For production servers, edit the daemon’s /etc/docker/daemon.json to set default limits:

{
 "default-runtime": "runc",
 "default-ulimits": {
 "nofile": {"Name": "nofile", "Hard": 64000, "Soft": 64000}
 }
}

Restart the daemon after changes: sudo systemctl restart docker.

Using .dockerignore to Speed Up Builds

Place a .dockerignore file in the same directory as your Dockerfile. List patterns you never want copied into the build context (e.g., .git, node_modules, *.log). This reduces transfer size and speeds up layer caching.

Implementing Multi‑Stage Builds

Multi‑stage builds let you compile code in a heavyweight image, then copy only the final artifact into a minimal runtime image.

FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM node:20-alpine
WORKDIR /app
COPY --from=builder /app/dist ./dist
CMD ["node","dist/index.js"]

The final image contains only the runtime files, shrinking attack surface and pulling time.

Common Installation Mistakes and Troubleshooting

Fixing “Docker Daemon Not Running” Errors

• On Linux, ensure the service is active: sudo systemctl start docker and enable it for boot.
• On Windows, verify WSL 2 is installed and the Linux kernel update is applied. Run wsl --update if needed.
• Check the log file (/var/log/docker.log or Docker Desktop diagnostics) for specific error messages.

Resolving Permission Denied Issues on Linux

If you see “permission denied while trying to connect to the Docker daemon socket”:

1. Add your user to the docker group (see earlier step).
2. Log out and back in, or run newgrp docker.
3. Confirm group membership with groups $USER.

Handling Port Conflict Errors

Docker reports “bind: address already in use” when a host port is occupied.

• Identify the conflicting process: sudo lsof -i :8080 or netstat -tulpn | grep 8080.
• Stop or reconfigure the offending service, or change the container’s published port with -p 8081:80.

Who is This Best For?