From 653563f7a15fb72b1cce993b456e9b7c0c0694c4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?R=C3=A9mi=20Berthoz?= Date: Mon, 15 Aug 2022 12:53:14 +0200 Subject: [PATCH] docs: add note on vhost.d files with acme-companion --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index dc8414b..6b66867 100644 --- a/README.md +++ b/README.md @@ -431,10 +431,14 @@ If you are using multiple hostnames for a single container (e.g. `VIRTUAL_HOST=e ln -s /path/to/vhost.d/www.example.com /path/to/vhost.d/example.com ``` +**NOTE**: If you use the [acme-companion](https://github.com/nginx-proxy/acme-companion) companion container, configuration files mounted in `/etc/nginx/vhost.d` will be appended by the container. Appended files contain an extra location, for ACME challenges, that should be left as-is. + #### Per-VIRTUAL_HOST default configuration If you want most of your virtual hosts to use a default single configuration and then override on a few specific ones, add those settings to the `/etc/nginx/vhost.d/default` file. This file will be used on any virtual host which does not have a `/etc/nginx/vhost.d/{VIRTUAL_HOST}` file associated with it. +**NOTE**: If you use the [acme-companion](https://github.com/nginx-proxy/acme-companion) companion container, configuration files mounted in `/etc/nginx/vhost.d` will be appended by the container. Appended files contain an extra location, for ACME challenges, that should be left as-is. + #### Per-VIRTUAL_HOST location configuration To add settings to the "location" block on a per-`VIRTUAL_HOST` basis, add your configuration file under `/etc/nginx/vhost.d` just like the previous section except with the suffix `_location`.