You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+45Lines changed: 45 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,6 +10,7 @@
10
10
**[Quick Start](#quick-start)** |
11
11
**[Settings](#settings)** |
12
12
**[Development](#development)** |
13
+
**[Localhost SSL](#localhost-ssl)** |
13
14
**[Composer](#composer)** |
14
15
**[MySQL](#mysql)** |
15
16
**[XDebug](#xdebug)** |
@@ -31,6 +32,7 @@ It is intended to provide everything needed to have a structured development LAM
31
32
- xdebug-3.1.1 (and documentation for connecting the Visual Studio Code debugger to the container)
32
33
- MySQL8
33
34
- PhpMyAdmin running by default on port 8080
35
+
- A mkcert container that generates certs for a dev domain
34
36
- Allowance for customization of mysql, php and apache configuration files
35
37
- Composer installed in the Server container
36
38
- A simple .env file that handles container naming, allowing for multiple unique container setups and port changes through simple text edits
@@ -87,6 +89,48 @@ docker-compose -d up
87
89
- start adding code, and/or packages with composer/composer.json
88
90
- Add your docker4lamp project to git
89
91
92
+
## Localhost SSL
93
+
94
+
docker4compose uses the [mkcert project](https://github.com/FiloSottile/mkcert) to generate valid SSL certificates for your _docker4lamp_ environment. This relieves you of having to install and run mkcert yourself, or reconfiguring the apache vhost.
95
+
96
+
All you need to do is retrieve the root cert from the container and install it in your workstation's local certificate store.
97
+
98
+
By default, the cert will allow for valid SSL access to *.**APP_NAME**.localhost
99
+
100
+
### Installing the cert
101
+
102
+
- The /cert directory is designed for you to keep a locally accessible copy of the generated certs
_Your browser should see your development server as valid when you open https://www.myproject.localhost_
130
+
131
+
#### Note for Firefox users:
132
+
By default Firefox does not trust root certs installed in the operating system. [You can work around this using Mozilla's documentation.](https://support.mozilla.org/en-US/kb/setting-certificate-authorities-firefox)
133
+
90
134
### Developing your code
91
135
92
136
Your code goes into the docker4lamp/_project_ directory. Don't change the name of this directory unless you are clear on changes you would need to make to your apache and debug settings
0 commit comments