Docker Installation Guide | Crusader Two-One

Docker is a platform for developing, shipping, and running applications in containers. This guide covers installing Docker on different operating systems.

Install

Ubuntu and Debian

Follow these steps to install Docker on Ubuntu or Debian-based distributions:

Update the apt package index and install packages to allow apt to use a repository over HTTPS:

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

Add Docker's official GPG key:

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/$(lsb_release -is | tr '[:upper:]' '[:lower:]')/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

Set up the repository:

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/$(lsb_release -is | tr '[:upper:]' '[:lower:]') \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Update the apt package index and install Docker:

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

Add your user to the docker group to run Docker commands without sudo:
```
sudo usermod -aG docker $USER
```
Note

Log out and back in for this change to take effect.

Verify the installation:

docker --version
docker run hello-world

CentOS/RHEL

Install required packages:

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

Add the Docker repository:

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

Install Docker:

sudo yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Start and enable Docker:

sudo systemctl start docker
sudo systemctl enable docker

Add your user to the docker group:
```
sudo usermod -aG docker $USER
```

Verify the installation:

docker --version
docker run hello-world

Windows 10/11 Professional, Enterprise, or Education

System Requirements:
- Windows 10/11 64-bit: Pro, Enterprise, or Education (Build 16299 or later)
- Hyper-V and Containers Windows features must be enabled
Download and Install:
- Download Docker Desktop for Windows
- Double-click the installer to run it
- Follow the installation wizard
Post-Installation:
- Start Docker Desktop from the Windows Start menu
- Verify the installation by running in PowerShell or Command Prompt:
```
docker --version
docker run hello-world
```

Windows 10 Home

System Requirements:
- Windows 10 64-bit Home (Build 19041 or later)
- WSL 2 must be installed
Install WSL 2:
- Open PowerShell as Administrator and run:
```
wsl --install
```
- Restart your computer
Download and Install Docker Desktop:
- Download Docker Desktop for Windows
- Double-click the installer to run it
- Follow the installation wizard
- Ensure "Use WSL 2 instead of Hyper-V" is checked

Verify Installation:

docker --version
docker run hello-world

macOS

System Requirements:
- macOS 11 (Big Sur) or newer for Intel Macs
- macOS 12 (Monterey) or newer for Apple Silicon (M1/M2) Macs
Download and Install:
- Download Docker Desktop for Mac (Intel) or Docker Desktop for Apple Silicon (M1/M2)
- Open the downloaded .dmg file
- Drag the Docker icon to the Applications folder
- Open Docker from the Applications folder
Verify Installation:
- Open Terminal and run:
```
docker --version
docker run hello-world
```

Troubleshooting

Common Issues

Repository does not have a Release file

If you encounter an error about missing Release files on Debian-based systems:

Check that the correct distribution name is used in the repository URL
See Proxmox Docker Repository Troubleshooting for a specific example

Docker daemon not running

If you get "Cannot connect to the Docker daemon" errors:

Check if the Docker service is running: sudo systemctl status docker
Start the service if needed: sudo systemctl start docker

Permission denied

If you get "permission denied" errors:

Make sure your user is in the docker group: groups
If not, add it and log out/in: sudo usermod -aG docker $USER

Table of Contents