Ticket #62196: windows-docker-docs.patch

README.md

@@ -45 +45 @@
 * Docker
 * Docker Compose
 
+## Running the Local Docker Environment on Windows
+
+The local Docker development environment is primarily documented for macOS and Linux.
+However, it **can also be run successfully on Windows** with a few additional steps.
+
+### Prerequisites (Windows)
+
+* Windows 10 or later (64-bit)
+* Docker Desktop for Windows
+* WSL 2 (Windows Subsystem for Linux)
+
+Ensure the following before proceeding:
+
+1. Enable **WSL 2** and install a Linux distribution (Ubuntu is recommended).
+2. In Docker Desktop settings:
+   - Enable **Use the WSL 2 based engine**
+   - Enable integration for your chosen Linux distribution
+
+### Setup Instructions (Windows)
+
+1. Clone the repository inside your WSL 2 Linux filesystem (not the Windows filesystem):
+
+   ```bash
+   git clone https://github.com/WordPress/wordpress-develop.git
+   cd wordpress-develop
+   ```
+
+2. From within WSL, start the Docker environment:
+
+   ```bash
+   npm install
+   npm run env:start
+   ```
+
+3. Access the site in your browser at:
+
+   ```
+   http://localhost:8889
+   ```
+
+### Notes for Windows Users
+
+* Running Docker from within WSL provides significantly better performance.
+* Avoid running the project from `/mnt/c/` or other Windows-mounted paths.
+* File permission issues are often resolved by ensuring the project lives entirely in WSL.
+
+These steps align the Windows setup experience more closely with macOS and Linux and
+reduce common errors related to file syncing and permissions.
+
 Environment Commands
 
 ```bash