From 2092a5f2b9c68189d2ad1fca741ff4bfe02f97a4 Mon Sep 17 00:00:00 2001 From: LinuxServer-CI Date: Tue, 30 Jul 2019 21:40:14 +0100 Subject: [PATCH] Bot Updating Templated Files --- images/docker-letsencrypt.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/images/docker-letsencrypt.md b/images/docker-letsencrypt.md index 273af8a49..2a7d8dbf7 100644 --- a/images/docker-letsencrypt.md +++ b/images/docker-letsencrypt.md @@ -113,7 +113,7 @@ Docker images are configured using parameters passed at runtime (such as those a | `TZ=Europe/London` | Specify a timezone to use EG Europe/London. | | `URL=yourdomain.url` | Top url you have control over (`customdomain.com` if you own it, or `customsubdomain.ddnsprovider.com` if dynamic dns). | | `SUBDOMAINS=www,` | Subdomains you'd like the cert to cover (comma separated, no spaces) ie. `www,ftp,cloud`. For a wildcard cert, set this _exactly_ to `wildcard` (wildcard cert is available via `dns` and `duckdns` validation only) | -| `VALIDATION=http` | Letsencrypt validation method to use, options are `http`, `tls-sni`, `dns` or `duckdns` (`dns` method also requires `DNSPLUGIN` variable set) (`duckdns` method requires `DUCKDNSTOKEN` variable set, and the `SUBDOMAINS` variable set to `wildcard`). | +| `VALIDATION=http` | Letsencrypt validation method to use, options are `http`, `tls-sni`, `dns` or `duckdns` (`dns` method also requires `DNSPLUGIN` variable set) (`duckdns` method requires `DUCKDNSTOKEN` variable set, and the `SUBDOMAINS` variable must be either empty or set to `wildcard`). | | `DNSPLUGIN=cloudflare` | Required if `VALIDATION` is set to `dns`. Options are `cloudflare`, `cloudxns`, `digitalocean`, `dnsimple`, `dnsmadeeasy`, `google`, `luadns`, `nsone`, `ovh`, `rfc2136` and `route53`. Also need to enter the credentials into the corresponding ini file under `/config/dns-conf`. | | `DUCKDNSTOKEN=` | Required if `VALIDATION` is set to `duckdns`. Retrieve your token from https://www.duckdns.org | | `EMAIL=` | Optional e-mail address used for cert expiration notifications. | @@ -152,7 +152,7 @@ In this instance `PUID=1000` and `PGID=1000`, to find yours use `id user` as bel * For `dns` validation, make sure to enter your credentials into the corresponding ini file under `/config/dns-conf` * Cloudflare provides free accounts for managing dns and is very easy to use with this image. Make sure that it is set up for "dns only" instead of "dns + proxy" * Google dns plugin is meant to be used with "Google Cloud DNS", a paid enterprise product, and not for "Google Domains DNS" -* For `duckdns` validation, set the `SUBDOMAINS` variable to `wildcard`, and set the `DUCKDNSTOKEN` variable with your duckdns token. Due to a limitation of duckdns, the resulting cert will only cover the sub-subdomains (ie. `*.yoursubdomain.duckdns.org`) but will not cover `yoursubdomain.duckdns.org`. Therefore, it is recommended to use a sub-subdomain like `www.yoursubdomain.duckdns.org` for subfolders. You can use our [duckdns image](https://hub.docker.com/r/linuxserver/duckdns/) to update your IP on duckdns.org. +* For `duckdns` validation, either leave the `SUBDOMAINS` variable empty or set it to `wildcard`, and set the `DUCKDNSTOKEN` variable with your duckdns token. Due to a limitation of duckdns, the resulting cert will only cover either main subdomain (ie. `yoursubdomain.duckdns.org`), or sub-subdomains (ie. `*.yoursubdomain.duckdns.org`), but will not both at the same time. You can use our [duckdns image](https://hub.docker.com/r/linuxserver/duckdns/) to update your IP on duckdns.org. * `--cap-add=NET_ADMIN` is required for fail2ban to modify iptables * If you need a dynamic dns provider, you can use the free provider duckdns.org where the `URL` will be `yoursubdomain.duckdns.org` and the `SUBDOMAINS` can be `www,ftp,cloud` with http validation, or `wildcard` with dns validation. * After setup, navigate to `https://yourdomain.url` to access the default homepage (http access through port 80 is disabled by default, you can enable it by editing the default site config at `/config/nginx/site-confs/default`). @@ -204,6 +204,7 @@ This will *ask* Google et al not to index and list your site. Be careful with th ## Versions +* **30.07.19:** - Support main domain via duckdns validation. * **29.07.19:** - Enable http to https redirect by default (effective only for new installs). * **01.07.19:** - Patch geoip2 module until upstream is fixed. * **30.06.19:** - Add geoip2 module.