Skip to content

Commit 4fdd78a

Browse files
Update 01-install-docker.md
Signed-off-by: Thomas Pichler <[email protected]>
1 parent 3d28d76 commit 4fdd78a

File tree

1 file changed

+50
-15
lines changed

1 file changed

+50
-15
lines changed
Lines changed: 50 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,55 @@
1-
# Step 1: Install Docker Desktop
1+
# Step 01 – Install & Configure Docker Desktop (Windows)
22

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.
54

6-
## 🧰 Prerequisites
7-
- Windows 10/11 with WSL2 support
8-
- Admin privileges
5+
---
96

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
158

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 |
1816

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

Comments
 (0)