This Dockerfile is intended to be used as a base for any web servers within Lagoon.
Lagoon & OpenShift adaptions¶
This image is prepared to be used on Lagoon, which leverages OpenShift. There are therefore some things already done:
- Folder permissions are automatically adapted with
fix-permissions, so this image will work with a random user, and therefore also on OpenShift.
- The files within
/etc/nginx/*are parsed through
envplatewith a container-entrypoint.
Nginx configuration (
If you need PHP, have a look at the
php-fpm image and use
php-fpm in tandem.
Build the content during the build process and inject it into the
In order to create redirects, we have
redirects-map.conf in place. This helps you to redirect marketing domains to sub-sites or do non-www to www redirects. If you have a lot of redirects, we suggest having
redirects-map.conf stored next to your code for easier maintainability.
If you just have a few redirects, there's a handy trick to create the redirects with a
RUN command in your
Here's an example showing how to redirect
example.com and preserve the request:
RUN echo "~^www\.example\.com http://example.com\$request_uri;" >> /etc/nginx/redirects-map.conf
To get more details about the various types of redirects that can be achieved, see the documentation within the
After you put the
redirects-map.conf in place, you also need to include it in your
nginx.dockerfile in order to get the configuration file into your build.
COPY redirects-map.conf /etc/nginx/redirects-map.conf
If you want to protect your site via basic authentication, you can do this by defining the environment variables
BASIC_AUTH_PASSWORD. For further explanation on how to set up Environment Variables on Lagoon, see the documentation page.
Environment variables are meant to contain common information for the
||By not setting
||(not set)||Username for basic authentication|
||(not set)||Password for basic authentication (unencrypted)|
||(not set)||If set to