HxHippy

Docker Installation

Complete guide to installing Docker on Linux, macOS, and Windows.

Last updated: 2025-01-15

Installing Docker

Docker can be installed on Linux, macOS, and Windows. Choose the method that fits your environment.

Linux Installation (Ubuntu/Debian)

Install Prerequisites

# Update package index
sudo apt update

# Install dependencies
sudo apt install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

Add Docker Repository

# Add Docker's official GPG key
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# Add Docker repository
echo "deb [arch=amd64 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

Install Docker Engine

# Update and install
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Verify installation
docker --version

Post-Installation Steps

# Add your user to docker group (no sudo required)
sudo usermod -aG docker $USER

# Apply group changes (or logout/login)
newgrp docker

# Enable Docker to start on boot
sudo systemctl enable docker
sudo systemctl start docker

# Test Docker
docker run hello-world

Linux Installation (RHEL/CentOS/Fedora)

# Remove old versions
sudo dnf remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine

# Set up repository
sudo dnf install -y dnf-plugins-core
sudo dnf config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo

# Install Docker Engine
sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Start and enable
sudo systemctl start docker
sudo systemctl enable docker

Arch Linux Installation

# Install from official repos
sudo pacman -S docker docker-compose

# Start and enable
sudo systemctl start docker
sudo systemctl enable docker

# Add user to docker group
sudo usermod -aG docker $USER

macOS Installation

Download Docker Desktop from docker.com/products/docker-desktop

# Or via Homebrew
brew install --cask docker

# Start Docker Desktop from Applications
# Verify
docker --version
docker compose version

Verifying Installation

# Check Docker version
docker version

# Check Docker info
docker info

# Run test container
docker run hello-world

# Check Docker Compose
docker compose version

Troubleshooting

Issue Solution
Permission denied Add user to docker group, logout/login
Cannot connect to daemon Start Docker service: sudo systemctl start docker
DNS issues Check /etc/docker/daemon.json DNS settings
Storage issues Prune unused data: docker system prune -a
beginner Getting Started Updated 2025-01-15
  • docker
  • install
  • setup
  • docker engine
  • docker desktop