[docs] Windows WSL2 offline usage (windows-side hosts file) [skip ci]…

…[ci skip] (#3119)
ddev · Jul 29, 2021 · b1e6a30 · b1e6a30
1 parent 409002a
commit b1e6a30
Showing 1 changed file with 10 additions and 0 deletions.
diff --git a/docs/users/cli-usage.md b/docs/users/cli-usage.md
@@ -750,3 +750,13 @@ In `.ddev/config.yaml` `use_dns_when_possible: false` will make ddev never try t
 In `.ddev/config.yaml` `project_tld: example.com` (or any other domain) can set ddev to use a project that could never be looked up in DNS. You can also use `ddev config --project-tld=example.com`
 
 You can also set up a local DNS server like dnsmasq (Linux and macOS, `brew install dnsmasq`) or ([unbound](https://github.com/NLnetLabs/unbound) or many others on Windows) in your own host environment that serves the project_tld that you choose, and DNS resolution will work just fine. You'll likely want a wildcard A record pointing to 127.0.0.1 (on most ddev installations). If you use dnsmasq you must configure it to allow DNS rebinding.
+
+If you're using a browser on Windows, accessing a DDEV project in WSL2, Windows will attempt to resolve the site name via DNS. If you do not have an internet connection, this will fail. To resolve this, update your `C:\Windows\System32\drivers\etc\hosts` file.
+
+```
+127.0.0.1 example.ddev.site
+```
+
+* Note: You must have administrative privileges to save this file.
+
+* See [Windows Hosts File limited to 10 hosts per IP address line](https://ddev.readthedocs.io/en/stable/users/troubleshooting/#windows-hosts-file-limited-to-10-hosts-per-ip-address-line) for additional troubleshooting.