]> git.street.me.uk Git - andy/dehydrated.git/blame - docs/hook_chain.md
renamed project to dehydrated and main script to dehydrated.sh
[andy/dehydrated.git] / docs / hook_chain.md
CommitLineData
7d0ef222
LS
1# HOOK_CHAIN
2
3If you want to deploy (and clean) all challenges for a single certificate in one hook call you can use `HOOK_CHAIN=yes` in your config.
4
5Calls to your hook script change in a way that instead of having only X parameters on deploy_challenge and clean_challenge it will have Y*X parameters,
6where Y is the number of domains in your cert, and you'll have to iterate over a set of X parameters at a time in your hook script.
7
8See below for an example on how the calls change:
9
10### HOOK_CHAIN="no" (default behaviour)
11```
64e35463 12# INFO: Using main config file /etc/dehydrated/config
7d0ef222
LS
13Processing lukas.im with alternative names: www.lukas.im
14 + Checking domain name(s) of existing cert... unchanged.
15 + Checking expire date of existing cert...
16 + Valid till Jul 7 20:54:00 2016 GMT (Longer than 30 days). Ignoring because renew was forced!
17 + Signing domains...
18 + Generating private key...
19 + Generating signing request...
20 + Requesting challenge for lukas.im...
21 + Requesting challenge for www.lukas.im...
22HOOK: deploy_challenge lukas.im blablabla blablabla.supersecure
23 + Responding to challenge for lukas.im...
24HOOK: clean_challenge lukas.im blablabla blablabla.supersecure
25 + Challenge is valid!
26HOOK: deploy_challenge www.lukas.im blublublu blublublu.supersecure
27 + Responding to challenge for www.lukas.im...
28HOOK: clean_challenge www.lukas.im blublublu blublublu.supersecure
29 + Challenge is valid!
30 + Requesting certificate...
31 + Checking certificate...
32 + Done!
33 + Creating fullchain.pem...
64e35463 34HOOK: deploy_cert lukas.im /etc/dehydrated/certs/lukas.im/privkey.pem /etc/dehydrated/certs/lukas.im/cert.pem /etc/dehydrated/certs/lukas.im/fullchain.pem /etc/dehydrated/certs/lukas.im/chain.pem 1460152442
7d0ef222
LS
35 + Done!
36```
37
38### HOOK_CHAIN="yes"
39```
64e35463 40# INFO: Using main config file /etc/dehydrated/config
7d0ef222
LS
41Processing lukas.im with alternative names: www.lukas.im
42 + Checking domain name(s) of existing cert... unchanged.
43 + Checking expire date of existing cert...
44 + Valid till Jul 7 20:52:00 2016 GMT (Longer than 30 days). Ignoring because renew was forced!
45 + Signing domains...
46 + Generating private key...
47 + Generating signing request...
48 + Requesting challenge for lukas.im...
49 + Requesting challenge for www.lukas.im...
50HOOK: deploy_challenge lukas.im blablabla blablabla.supersecure www.lukas.im blublublu blublublu.supersecure
51 + Responding to challenge for lukas.im...
52 + Challenge is valid!
53 + Responding to challenge for www.lukas.im...
54 + Challenge is valid!
55HOOK: clean_challenge lukas.im blablabla blablabla.supersecure www.lukas.im blublublu blublublu.supersecure
56 + Requesting certificate...
57 + Checking certificate...
58 + Done!
59 + Creating fullchain.pem...
64e35463 60HOOK: deploy_cert lukas.im /etc/dehydrated/certs/lukas.im/privkey.pem /etc/dehydrated/certs/lukas.im/cert.pem /etc/dehydrated/certs/lukas.im/fullchain.pem /etc/dehydrated/certs/lukas.im/chain.pem 1460152408
7d0ef222
LS
61 + Done!
62```
63