Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
116 changes: 112 additions & 4 deletions src/components/quickstart/Windows.astro
Original file line number Diff line number Diff line change
@@ -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
}
Expand Down Expand Up @@ -60,11 +64,11 @@ const { latestVersion } = Astro.props
href={`https://github.com/ddev/ddev/releases/download/${latestVersion}/ddev_windows_amd64_installer.${latestVersion}.exe`}
/>
</div>

<p>Run the installer selecting the preferred "Docker CE" approach and selecting your "DDEV" distro. You can also find all releases at <a href="https://github.com/ddev/ddev/releases">DDEV Releases</a>.</p>

<p>
In the “DDEV” terminal app or Windows Terminal, confirm that the <code>ddev</code> binary is
In the “DDEV” terminal app or Windows Terminal "DDEV" profile, confirm that the <code>ddev</code> binary is
installed: 🎉
</p>
<Terminal
Expand All @@ -73,7 +77,111 @@ const { latestVersion } = Astro.props
/>
</div>

<Examples itemNumber="3/3" terminalType="powershell-ubuntu" terminalSymbol="$" />
<div class="prose dark:prose-invert">
<h2 class="text-3xl mt-24">
<small class="block font-mono text-xs text-gray-500">{itemNumber}</small>Create a
Project
</h2>

<p>Tip: Watch the <a href="/blog/watch-ddev-local-from-scratch-with-windows-wsl2/">video tutorial</a> showing all of this.</p>

<p><strong>Important:</strong> 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.</p>

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

<p>Create a directory for your project:</p>
<Terminal type={terminalType} code={`${terminalSymbol} mkdir -p ~/dev/my-project && cd ~/dev/my-project`} />

<p>
Initialize the project by running the <a
href="https://docs.ddev.com/en/stable/users/usage/commands/#config"
target="_blank"
><code>ddev config</code></a>
command:
</p>
<Terminal type={terminalType} code={`${terminalSymbol} ddev config`} />

<p>
Start the project for the first time. You'll use the same command to start
it later, too!
</p>
<Terminal type={terminalType} code={`${terminalSymbol} ddev start`} />

<p>
If it's a Composer project, you may also need to run <a
href="https://docs.ddev.com/en/stable/users/usage/commands/#composer"
target="_blank"
><code>ddev composer install</code></a>.
</p>

<p>
Now run the <a
href="https://docs.ddev.com/en/stable/users/usage/commands/#launch"
target="_blank">launch command</a
> to open your project in a browser:
</p>
<Terminal type={terminalType} code={`${terminalSymbol} ddev launch`} />
</div>

<div class="prose dark:prose-invert">
<h2 class="text-3xl mt-24">Explore & Enjoy!</h2>

<p>
Take a peek at your project's new <code>.ddev/</code> directory. You can add
this to your repo to share your DDEV config, edit <code
>.ddev/config.yaml</code
> to change <a
href="https://docs.ddev.com/en/stable/users/configuration/config/"
target="_blank"
>project options</a
>, or even go about your business and pretend this folder doesn't exist.
</p>

<p>
Run the <a
href="https://docs.ddev.com/en/stable/users/usage/commands/#help"
target="_blank"
>help command</a>
(or plain <code>ddev</code>) to see the actions you can take with the CLI:
</p>

<Terminal type={terminalType} code={`${terminalSymbol} ddev -h`} />

<p>
Use the <a
href="https://docs.ddev.com/en/stable/users/usage/commands/#describe"
target="_blank"
>describe command</a>
to see a project's parts and database connection details:
</p>

<Terminal type={terminalType} code={`${terminalSymbol} ddev describe`} />

<p>
If you're done working on a project and want to shut it down without
removing anything, use the <a
href="https://docs.ddev.com/en/stable/users/usage/commands/#stop"
target="_blank"
>stop command</a>:
</p>

<Terminal type={terminalType} code={`${terminalSymbol} ddev stop`} />

<p>
If you were just kicking the tires and you want to permanently delete the
project and its resources without touching your code, run the <a
href="https://docs.ddev.com/en/stable/users/usage/commands/#delete"
target="_blank"
>delete command</a>:
</p>

<Terminal type={terminalType} code={`${terminalSymbol} ddev delete`} />

<p>
DDEV will remove everything it created for the project and have no memory of
its existence.
</p>
</div>

<div class="prose dark:prose-invert">
<p></p>
Expand Down