Skip to content

Commit 804374b

Browse files
authored
Add more hints when using Symfony CLI in Windows
1 parent dbd1fee commit 804374b

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

setup/symfony_server.rst

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -106,6 +106,14 @@ trust store, registers it in Firefox (this is required only for that browser)
106106
and creates a default certificate for ``localhost`` and ``127.0.0.1``. In other
107107
words, it does everything for you.
108108

109+
.. tip::
110+
111+
If you are doing this in WSL (Windows Subsystem for Linux), the newly created
112+
local certificate authority needs to be imported in Windows. The file is located
113+
in `wsl` at `~/.symfony5/certs/default.p12`. The easiest way to do so is to open
114+
`\\wsl$\Ubuntu\home\` in `Explorer` and then navigate through your username to
115+
`.symfony/certs` and double-click the `default.p12`.
116+
109117
Before browsing your local application with HTTPS instead of HTTP, restart its
110118
server stopping and starting it again.
111119

@@ -223,6 +231,9 @@ If the proxy doesn't work as explained in the following sections, check these:
223231
* Some Operating Systems (e.g. macOS) don't apply by default the proxy settings
224232
to local hosts and domains. You may need to remove ``*.local`` and/or other
225233
IP addresses from that list.
234+
* Windows Operating System **requires** `localhost` instead of `127.0.0.1` when
235+
when configuring automatic proxy, otherwise you won't be able to access your
236+
local domain from your browser running in Windows.
226237

227238
Defining the Local Domain
228239
~~~~~~~~~~~~~~~~~~~~~~~~~

0 commit comments

Comments
 (0)