Docker Installation Guide¶

This guide provides instructions for installing Docker on both Linux and Windows systems. Always refer to official documentation for the most accurate and up-to-date instructions. Offline installers are available upon request.

Docker Installation for Linux¶

System Requirements¶

Supported Distributions: Docker Engine supports a variety of Linux distributions, including Ubuntu, Debian, CentOS, Fedora, and others.
Docker Version: Docker Engine 26 or higher is recommended for optimal compatibility.

Steps to Install Docker on Linux¶

Refer to the Official Documentation:
- Visit the Official Docker Installation Guide for detailed, distribution-specific instructions.
Enable and Start Docker:
- Enable Docker to start on boot and start the service:
  Bash
```
sudo systemctl enable docker
sudo systemctl start docker
```
Verify Installation:
- Verify that Docker is installed and running:
  Bash
```
docker --version
docker run hello-world
```

Docker Installation for Windows¶

For Windows, WSL 2 is a mandatory backend for running Docker.

System Requirements¶

WSL Version: 1.1.3.0 or later.
Operating System: Windows Server 2022 (build 20348) or higher is recommended.
Processor: A 64-bit processor with Second Level Address Translation (SLAT) support.
Hardware Virtualization: Ensure Nested Virtualization is enabled in the BIOS settings. For more details, refer to the Virtualization Overview.

Steps to Install Docker on Windows¶

1. Enable WSL 2 on Windows¶

Follow the official Microsoft WSL installation guide: Install WSL.

Open PowerShell as Administrator and run the following commands to enable WSL and set WSL 2 as the default version:

PowerShell

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
wsl --set-default-version 2

Restart your computer after enabling these features.

2. Install a Linux Distribution for WSL¶

Download and install a Linux distribution (e.g., Ubuntu) from the Microsoft Store.
After installation, initialize the Linux distribution by setting up a username and password.

3. Install Docker Desktop¶

Download and install Docker Desktop from the Docker Desktop Release Notes.
During installation, select the Use WSL 2 instead of Hyper-V option.

4. Verify Docker Installation¶

Open a terminal (PowerShell, Command Prompt, or WSL) and run:
Bash
```
docker version
docker run hello-world
```

Offline Installation¶

For environments without internet access, we can provide offline installers for Docker. Please contact [email protected] to request offline installation packages and instructions.

Verify Docker Installation¶

After installing Docker, ensure that it is correctly set up by performing the following steps:

Check Docker Version:
Run the following command to verify the installed Docker version:
Bash
```
docker version
```
Run a Test Container:
Confirm Docker functionality by running the hello-world container:
Bash
```
docker run hello-world
```
Check Resource Allocation:
For performance issues, ensure that sufficient resources are allocated in Docker Desktop settings (Windows) or system configurations (Linux).

Important Notes¶

Always refer to the official Docker documentation for the latest installation instructions:
Docker Installation Guide
Docker Desktop for Windows
Hardware Prerequisites for WSL 2:
A 64-bit processor with Second Level Address Translation (SLAT) support.
Hardware virtualization must be enabled in the BIOS.