Skip to content

Commit

Permalink
docs: be more explicit about where projects go in home dir (ddev#5955)…
Browse files Browse the repository at this point in the history
… [skip ci]

Co-authored-by: Christian López Espínola <penyaskito@computer.org>
  • Loading branch information
rfay and penyaskito committed Mar 12, 2024
1 parent 5030f72 commit ae4128b
Showing 1 changed file with 2 additions and 2 deletions.
4 changes: 2 additions & 2 deletions docs/content/users/install/ddev-installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -154,8 +154,8 @@ Once you’ve [installed a Docker provider](docker-installation.md), you’re re

* Execute DDEV commands inside WSL2.
You’ll want to run DDEV commands inside Ubuntu, for example, and never on the Windows side in PowerShell or Git Bash.
* Projects should live in the Linux filesystem.
WSL2’s Linux filesystem (e.g. `/home/<your_username>`) is much faster, so keep your projects there and **not** in the slower Windows filesystem (`/mnt/c`).
* Projects should live under the home directory of the Linux filesystem.
WSL2’s Linux filesystem (e.g. `/home/<your_username>`) is much faster and has proper permissions, so keep your projects there and **not** in the slower Windows filesystem (`/mnt/c`).
* Custom hostnames are managed via the Windows hosts file, not within WSL2.
DDEV attempts to manage custom hostnames via the Windows-side hosts file—usually at `C:\Windows\system32\drivers\etc\hosts`—and it can only do this if it’s installed on the Windows side. (DDEV inside WSL2 uses `ddev.exe` on the Windows side as a proxy to update the Windows hosts file.) If `ddev.exe --version` shows the same version as `ddev --version` you’re all set up. Otherwise, install DDEV on Windows using `choco upgrade -y ddev` or by downloading and running the Windows installer. (The WSL2 scripts below install DDEV on the Windows side, taking care of that for you.) If you frequently run into Windows UAC Escalation, you can calm it down by running `gsudo.exe cache on` and `gsudo.exe config CacheMode auto`, see [gsudo docs](https://github.com/gerardog/gsudo#credentials-cache).
* WSL2 is not the same as Docker Desktop’s WSL2 engine.
Expand Down

0 comments on commit ae4128b

Please sign in to comment.