|
1 | | -# Step 1: Install Docker Desktop |
| 1 | +# Step 01 – Install & Configure Docker Desktop (Windows) |
2 | 2 |
|
3 | | -## 🎯 Goal |
4 | | -Install Docker Desktop to enable containerized development with Web4.x. |
| 3 | +This step walks through downloading, installing, and initializing Docker Desktop on a Windows machine, including WSL integration. The goal is to get Docker ready for use in a development environment that can later be replicated or adapted cross-platform. |
5 | 4 |
|
6 | | -## 🧰 Prerequisites |
7 | | -- Windows 10/11 with WSL2 support |
8 | | -- Admin privileges |
| 5 | +--- |
9 | 6 |
|
10 | | -## 📦 Download & Install |
11 | | -1. Visit the official Docker Desktop site: [https://www.docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop) |
12 | | -2. Download and run the installer. |
13 | | -3. Enable the WSL 2 backend when prompted. |
14 | | -4. Restart your system if necessary. |
| 7 | +## 🧭 Overview |
15 | 8 |
|
16 | | -## ✅ Verification |
17 | | -Run the following in your terminal: |
| 9 | +| Step | Action | |
| 10 | +|------|--------| |
| 11 | +| [1.1](#11-download-docker-desktop) | Download Docker Desktop for Windows (Intel/AMD) | |
| 12 | +| [1.2](#12-run-the-installer--reboot) | Run the installer and reboot when prompted | |
| 13 | +| [1.3](#13-first-launch--docker-login) | Launch Docker Desktop and log in | |
| 14 | +| [1.4](#14-update-the-windows-subsystem-for-linux-wsl) | Update the Windows Subsystem for Linux (WSL) via PowerShell | |
| 15 | +| [1.5](#15-restart-docker-desktop) | Restart Docker to finalize the WSL integration | |
18 | 16 |
|
19 | | -```bash |
20 | | -docker --version |
| 17 | +--- |
| 18 | + |
| 19 | +## 🧩 Detailed Steps |
| 20 | + |
| 21 | +### 1.1 Download Docker Desktop |
| 22 | + |
| 23 | +- Go to: [https://www.docker.com/products/docker-desktop/](https://www.docker.com/products/docker-desktop/) |
| 24 | +- Choose the version labeled: **Windows (Intel/AMD)** |
| 25 | +- Click to download the `.exe` installer |
| 26 | + |
| 27 | +> 💡 Note: The “Intel/AMD” version refers to the standard x86-64 architecture. This is the correct version for most Windows laptops and desktops, regardless of whether the CPU is from Intel or AMD. Do **not** choose the ARM version unless you're running Windows on ARM. |
| 28 | +
|
| 29 | +--- |
| 30 | + |
| 31 | +### 1.2 Run the Installer & Reboot |
| 32 | + |
| 33 | +- Launch the downloaded installer |
| 34 | +- Follow the prompts and agree to any optional configuration Docker may suggest |
| 35 | +- When prompted, **reboot your system** |
| 36 | + |
| 37 | +--- |
| 38 | + |
| 39 | +### 1.3 First Launch & Docker Login |
| 40 | + |
| 41 | +- After reboot, Docker Desktop will start automatically |
| 42 | +- Sign in using your Docker Hub credentials |
| 43 | + > If you don’t have an account, you can create one at [https://hub.docker.com/signup](https://hub.docker.com/signup) |
| 44 | +
|
| 45 | +--- |
| 46 | + |
| 47 | +### 1.4 Update the Windows Subsystem for Linux (WSL) |
| 48 | + |
| 49 | +Docker Desktop will notify you that WSL needs to be updated. To do so: |
| 50 | + |
| 51 | +1. Open **PowerShell** as administrator |
| 52 | +2. Run the following command: |
| 53 | + |
| 54 | + ```powershell |
| 55 | + wsl --update |
0 commit comments