diff --git a/README.md b/README.md
index abcdef01..12345678 100644
--- a/README.md
+++ b/README.md
@@ Some existing section about Docker setup:
 
+### 🧩 Windows-specific setup instructions
+
+For users on **Windows**, follow these additional steps to ensure the local Docker environment works correctly:
+
+- **Install WSL 2** (Windows Subsystem for Linux version 2) and a Linux distribution (e.g. Ubuntu).
+  Enable integration with Docker Desktop via *Settings → Resources → WSL Integration*.
+- Ensure Docker is configured to use **Linux containers**—right-click Docker tray icon and select *“Switch to Linux containers…”* if available.
+- If you prefer not to use WSL, confirm Docker is already using Linux container mode—look for *“Switch to Windows containers…”* in the menu.
+- Optionally, install WordPress core code within your **WSL 2 environment** for compatibility and speed.
+
+These instructions ensure compatibility as Windows file systems and container engines have subtle differences.