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-releaseAdd 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/nullInstall 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 --versionPost-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-worldLinux 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 dockerArch 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 $USERmacOS 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 versionVerifying Installation
# Check Docker version
docker version
# Check Docker info
docker info
# Run test container
docker run hello-world
# Check Docker Compose
docker compose versionTroubleshooting
| 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 |
- docker
- install
- setup
- docker engine
- docker desktop