From 7d08f8a81c4ac3543853db51d8ac0022fdc96376 Mon Sep 17 00:00:00 2001 From: Michael Etokakpan Date: Fri, 11 Sep 2026 21:35:43 +0100 Subject: [PATCH] Build/Test Tools: Document Windows Docker setup --- README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.md b/README.md index 028c0bd5b1f63..d90bdc3f8bd70 100644 --- a/README.md +++ b/README.md @@ -41,6 +41,14 @@ You will also need a container environment such as [Docker Desktop](https://www. **Note:** WordPress currently only officially supports Docker but several container environments are available and should generally be compatible, such as [Colima](https://github.com/abiosoft/colima), [OrbStack](https://orbstack.dev/), [Podman Desktop](https://podman-desktop.io/), and [Rancher Desktop](https://rancherdesktop.io/). +#### Windows-specific instructions + +For development on Windows, [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) is recommended. This provides a Linux environment where the general development instructions can be used without modification. + +After installing Docker Desktop, enable Docker's WSL integration under **Settings > Resources > WSL integration**. This only needs to be configured once. + +If you use Docker Desktop directly from Windows without WSL, make sure it is using Linux containers. Right-click the Docker icon in the system tray and select **Switch to Linux containers...**. If that option is not available, or the menu shows **Switch to Windows containers...**, Docker is already using Linux containers. You can switch between container types later if another project requires Windows containers. + ### Development Environment Commands Ensure your container environment is running before using these commands.