Create documentation for zero-configuration-mode
This commit is contained in:
parent
7d1f62af77
commit
52e7c7b506
42
zero-config-mode.md
Normal file
42
zero-config-mode.md
Normal file
|
@ -0,0 +1,42 @@
|
||||||
|
# Zero-configuration mode
|
||||||
|
|
||||||
|
This is a tutorial on how to use this container (without needing to configure anything) to create
|
||||||
|
certificates for a given set of domains (using the HTTP-Challenge).
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
These are the things that you need to setup / already have set up in order to use this container
|
||||||
|
for creating certificates using the HTTP-Challenge:
|
||||||
|
|
||||||
|
- A working internet connection, obviously
|
||||||
|
- HTTP Webserver to serve the ``.well-known`` which is used for the HTTP-Challenge
|
||||||
|
|
||||||
|
Now create a folder in which dehydrated can push the challenge-data later, in this tutorial it
|
||||||
|
will be called ``dehydrated-www``. Configure your Webserver to serve the contents of this folder
|
||||||
|
under ``domain``/.well-known/ (for all domains which you want to create certificates for).
|
||||||
|
|
||||||
|
Next create another folder in which dehydrated will place its configuration, certificates etc.,
|
||||||
|
in this tutorial it will be called ``dehydrated-data``. In this folder, create a file called
|
||||||
|
``domains.txt`` in which you list the domains you want to create certificates for, using the
|
||||||
|
following format:
|
||||||
|
|
||||||
|
- each domain on a new line
|
||||||
|
- subdomains of a domain on the same line as the domain.
|
||||||
|
|
||||||
|
For more information on the format, see [https://github.com/lukas2511/dehydrated/blob/master/docs/domains_txt.md](https://github.com/lukas2511/dehydrated/blob/master/docs/domains_txt.md)
|
||||||
|
|
||||||
|
## Using docker-dehydrated
|
||||||
|
|
||||||
|
Now you can just run the container, and as the default challenge is the HTTP-Challenge, you do
|
||||||
|
not need to pass environment variables to alter the default behaviour. To run the container,
|
||||||
|
execute:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ docker run -v ./dehydrated-www:/var/www/dehydrated -v ./dehydrated-data:/etc/dehydrated jcgruenhage/dehydrated
|
||||||
|
```
|
||||||
|
|
||||||
|
Please note that on SELinux-Systems, you need to set the "SELinux"-Flag when passing volumes:
|
||||||
|
``./dehydrated-www:/var/www/dehydrated:z`` (analog for ``dehydrated-data``).
|
||||||
|
|
||||||
|
Also, the container will ``chown`` the folders passed to himself, so make sure your webserver can
|
||||||
|
still server the contents of ``dehydrated-www``.
|
Loading…
Reference in a new issue