From 8917f03f8346436a5320f76208ca3c53a2141f3f Mon Sep 17 00:00:00 2001 From: Randy Fay Date: Fri, 19 Sep 2025 09:09:18 -0600 Subject: [PATCH 1/3] docs: Give better instructions for WSL2 users to work inside distro --- src/components/quickstart/Windows.astro | 110 +++++++++++++++++++++++- 1 file changed, 106 insertions(+), 4 deletions(-) diff --git a/src/components/quickstart/Windows.astro b/src/components/quickstart/Windows.astro index f17723d8..b7a3f1dc 100644 --- a/src/components/quickstart/Windows.astro +++ b/src/components/quickstart/Windows.astro @@ -1,9 +1,13 @@ --- import Terminal from "@components/Terminal.astro" import CommunityCTA from "./CommunityCTA.astro" -import Examples from "./Examples.astro" import CtaButton from "@components/CtaButton.astro" +// Set the props for the "Create a Project" section +const itemNumber = "3/3"; +const terminalType = "powershell-ubuntu"; +const terminalSymbol = "$"; + export interface Props { latestVersion: string } @@ -60,11 +64,11 @@ const { latestVersion } = Astro.props href={`https://github.com/ddev/ddev/releases/download/${latestVersion}/ddev_windows_amd64_installer.${latestVersion}.exe`} /> - +

Run the installer selecting the preferred "Docker CE" approach and selecting your "DDEV" distro. You can also find all releases at DDEV Releases.

- In the “DDEV” terminal app or Windows Terminal, confirm that the ddev binary is + In the “DDEV” terminal app or Windows Terminal "DDEV" profile, confirm that the ddev binary is installed: 🎉

- +
+

+ {itemNumber}Create a + Project +

+ +

Inside the WSL2 "DDEV" distro (not on Windows), create a directory for your project or clone your project:

+ + +

+ Initialize the project by running the ddev config + command: +

+ + +

+ Start the project for the first time. You'll use the same command to start + it later, too! +

+ + +

+ If it's a Composer project, you may also need to run ddev composer install. +

+ +

+ Now run the launch command to open your project in a browser: +

+ +
+ +
+

Explore & Enjoy!

+ +

+ Take a peek at your project's new .ddev/ directory. You can add + this to your repo to share your DDEV config, edit .ddev/config.yaml to change project options, or even go about your business and pretend this folder doesn't exist. +

+ +

+ Run the help command + (or plain ddev) to see the actions you can take with the CLI: +

+ + + +

+ Use the describe command + to see a project's parts and database connection details: +

+ + + +

+ If you're done working on a project and want to shut it down without + removing anything, use the stop command: +

+ + + +

+ If you were just kicking the tires and you want to permanently delete the + project and its resources without touching your code, run the delete command: +

+ + + +

+ DDEV will remove everything it created for the project and have no memory of + its existence. +

+

From 151d7ad67f1f1c0e687caa3212e7f762b0c9e76b Mon Sep 17 00:00:00 2001 From: Randy Fay Date: Fri, 19 Sep 2025 15:27:14 -0600 Subject: [PATCH 2/3] @stasadev suggestions to get Windows users into WSL --- src/components/quickstart/Windows.astro | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/components/quickstart/Windows.astro b/src/components/quickstart/Windows.astro index b7a3f1dc..c191bd7e 100644 --- a/src/components/quickstart/Windows.astro +++ b/src/components/quickstart/Windows.astro @@ -83,7 +83,9 @@ const { latestVersion } = Astro.props Project -

Inside the WSL2 "DDEV" distro (not on Windows), create a directory for your project or clone your project:

+

Tip: Watch the video tutorial showing all of this.

+ +

Inside the WSL2 "DDEV" distro create a directory for your project or clone your project. (This is not on the C:\ drive; Use the "DDEV" or "Windows Terminal" apps to access it. Or use Explorer > Linux > DDEV > /home/<you> to see the files.)

From 0333d68a3331f51edf2071e7abfeeb96c4bf0a55 Mon Sep 17 00:00:00 2001 From: Randy Fay Date: Fri, 19 Sep 2025 15:32:57 -0600 Subject: [PATCH 3/3] docs: Improve Windows WSL2 distro instructions clarity MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Break up confusing paragraph into clear, focused sections for Windows users working inside WSL2 DDEV distro. Add prominent warning about working inside WSL2 rather than Windows drive and simplify file access instructions. 🤖 Developed with assistance from [Claude Code](https://claude.ai/code) Co-Authored-By: Claude --- src/components/quickstart/Windows.astro | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/src/components/quickstart/Windows.astro b/src/components/quickstart/Windows.astro index c191bd7e..d9bd3eff 100644 --- a/src/components/quickstart/Windows.astro +++ b/src/components/quickstart/Windows.astro @@ -85,7 +85,11 @@ const { latestVersion } = Astro.props

Tip: Watch the video tutorial showing all of this.

-

Inside the WSL2 "DDEV" distro create a directory for your project or clone your project. (This is not on the C:\ drive; Use the "DDEV" or "Windows Terminal" apps to access it. Or use Explorer > Linux > DDEV > /home/<you> to see the files.)

+

Important: Work inside the WSL2 "DDEV" distro, not on your Windows C:\ drive. Open the "DDEV" app from your Start menu to access the Linux terminal.

+ +

To view files from Windows Explorer or your IDE: Explorer > Linux > DDEV > home > [your-username]

+ +

Create a directory for your project: