]> git.ipfire.org Git - thirdparty/haproxy.git/commitdiff
DOC: acme: crt-store allows you to start without a certificate
authorWilliam Lallemand <wlallemand@haproxy.com>
Thu, 6 Nov 2025 12:34:36 +0000 (13:34 +0100)
committerWilliam Lallemand <wlallemand@haproxy.com>
Thu, 6 Nov 2025 12:40:42 +0000 (13:40 +0100)
If your acme certificate is declared in a crt-store, and the certificate
file does not exist on the disk, HAProxy will start with a temporary key
pair.

doc/configuration.txt

index 7df51521b5561ffe8608251e3eb835f8b2ae423c..42cd5f8830b72130c642c4075d02dae9d9d58c4a 100644 (file)
@@ -30805,6 +30805,12 @@ acme <string>
   This is an experimental feature which needs the
   "expose-experimental-directives" keyword in the global section.
 
+  When using the "acme" keyword in a crt-store, it is possible to start without
+  an existing certificate on the disk. Instead, a temporary key pair will be
+  used until the ACME certificate is generated. This behavior is exclusives to
+  crt-stores, neither a crt-list line nor an ssl-f-use line can achieve the
+  same without declaring a crt-store first.
+
   See also Section 12.8 ("ACME") and "domains" in this section.
 
 alias <string>