diff --git a/httpd/README.md b/httpd/README.md index 0efe3e9fc..267639664 100644 --- a/httpd/README.md +++ b/httpd/README.md @@ -94,9 +94,31 @@ COPY ./my-httpd.conf /usr/local/apache2/conf/httpd.conf #### SSL/HTTPS -If you want to run your web traffic over SSL, the simplest setup is to `COPY` or mount (`-v`) your `server.crt` and `server.key` into `/usr/local/apache2/conf/` and then customize the `/usr/local/apache2/conf/httpd.conf` by removing the comment from the line with `#Include conf/extra/httpd-ssl.conf`. This config file will use the certificate files previously added and tell the daemon to also listen on port 443. Be sure to also add something like `-p 443:443` to your `docker run` to forward the https port. +If you want to run your web traffic over SSL, the simplest setup is to `COPY` or mount (`-v`) your `server.crt` and `server.key` into `/usr/local/apache2/conf/` and then customize the `/usr/local/apache2/conf/httpd.conf` by removing the comment symbol from the following lines: -The previous steps should work well for development, but we recommend customizing your conf files for production, see [httpd.apache.org](https://httpd.apache.org/docs/2.2/ssl/ssl_faq.html) for more information about SSL setup. +```apacheconf +... +#LoadModule socache_shmcb_module modules/mod_socache_shmcb.so +... +#LoadModule ssl_module modules/mod_ssl.so +... +#Include conf/extra/httpd-ssl.conf +... +``` + +The `conf/extra/httpd-ssl.conf` configuration file will use the certificate files previously added and tell the daemon to also listen on port 443. Be sure to also add something like `-p 443:443` to your `docker run` to forward the https port. + +This could be accomplished with a `sed` line similar to the following: + +```dockerfile +RUN sed -i \ + -e 's/^#\(Include .*httpd-ssl.conf\)/\1/' \ + -e 's/^#\(LoadModule .*mod_ssl.so\)/\1/' \ + -e 's/^#\(LoadModule .*mod_socache_shmcb.so\)/\1/' \ + conf/httpd.conf +``` + +The previous steps should work well for development, but we recommend customizing your conf files for production, see [httpd.apache.org](https://httpd.apache.org/docs/2.4/ssl/ssl_faq.html) for more information about SSL setup. # Image Variants