Skip to content

Commit d68b44a

Browse files
author
HAProxy Community
committed
Update docs for dev
1 parent 3c49f89 commit d68b44a

3 files changed

Lines changed: 50 additions & 22 deletions

File tree

‎docs/dev/configuration.html‎

Lines changed: 42 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<html lang="en">
33
<head>
44
<meta charset="utf-8" />
5-
<title>HAProxy version 3.4-dev7-110 - Configuration Manual</title>
5+
<title>HAProxy version 3.4-dev7-147 - Configuration Manual</title>
66
<link href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" />
77
<link href="https://raw.githubusercontent.com/thomaspark/bootswatch/v3.3.7/cerulean/bootstrap.min.css" rel="stylesheet" />
88
<link href="../css/page.css?0.4.2-15" rel="stylesheet" />
@@ -4884,7 +4884,7 @@
48844884
You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br>
48854885
</p>
48864886
<p class="text-right">
4887-
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/04/01</b></small>
4887+
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/04/02</b></small>
48884888
</p>
48894889
</div>
48904890
<!-- /.sidebar -->
@@ -4895,7 +4895,7 @@
48954895
<div class="text-center">
48964896
<h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1>
48974897
<h2>Configuration Manual</h2>
4898-
<p><strong>version 3.4-dev7-110</strong></p>
4898+
<p><strong>version 3.4-dev7-147</strong></p>
48994899
<p>
49004900
2026/03/20<br>
49014901

@@ -22294,6 +22294,7 @@ <h2 id="chapter-5.1" data-target="5.1"><small><a class="small" href="#5.1">5.1.<
2229422294
a bind line :
2229522295

2229622296
quic : mode=HTTP side=FE|BE mux=QUIC flags=HTX|NO_UPG|FRAMED
22297+
qmux : mode=HTTP side=FE|BE mux=QMUX flags=HTX|NO_UPG
2229722298
h2 : mode=HTTP side=FE|BE mux=H2 flags=HTX|HOL_RISK|NO_UPG
2229822299
h1 : mode=HTTP side=FE|BE mux=H1 flags=HTX|NO_UPG
2229922300
none : mode=TCP side=FE|BE mux=PASS flags=NO_UPG
@@ -22306,6 +22307,10 @@ <h2 id="chapter-5.1" data-target="5.1"><small><a class="small" href="#5.1">5.1.<
2230622307
If the ALPN or the NPN settings are configured, the specified protocols
2230722308
should be compatible with the multiplexer's protocol to avoid any issue. For
2230822309
instance, if &quot;proto h1&quot; is set, the ALPN should not be set to &quot;h2&quot;.
22310+
22311+
QMux is a subset of QUIC which runs over TCP. It corresponds to the following
22312+
draft protocol https://www.ietf.org/archive/id/draft-opik-quic-qmux-01.html.
22313+
It is considered experimental in haproxy for now.
2230922314
</pre><a class="anchor" name="quic-cc-algo"></a><a class="anchor" name="5-quic-cc-algo"></a><a class="anchor" name="5.1-quic-cc-algo"></a><a class="anchor" name="quic-cc-algo (Bind and server options)"></a><a class="anchor" name="quic-cc-algo (Bind options)"></a><div class="keyword"><b><a class="anchor" name="quic-cc-algo"></a><a href="#5.1-quic-cc-algo">quic-cc-algo</a></b> <span style="color: #800">{ cubic | newreno | bbr | nocc }</span><span style="color: #008">[(<span style="color: #080">&lt;args,...&gt;</span>)]</span></div><pre class="text">This is a QUIC specific setting to select the congestion control algorithm
2231022315
for any connection attempts to the configured QUIC listeners. They are
2231122316
similar to those used by TCP.
@@ -23638,6 +23643,7 @@ <h2 id="chapter-5.2" data-target="5.2"><small><a class="small" href="#5.2">5.2.<
2363823643
a server line :
2363923644

2364023645
quic : mode=HTTP side=FE|BE mux=QUIC flags=HTX|NO_UPG|FRAMED
23646+
qmux : mode=HTTP side=FE|BE mux=QMUX flags=HTX|NO_UPG
2364123647
h2 : mode=HTTP side=FE|BE mux=H2 flags=HTX|HOL_RISK|NO_UPG
2364223648
fcgi : mode=HTTP side=BE mux=FCGI flags=HTX|HOL_RISK|NO_UPG
2364323649
h1 : mode=HTTP side=FE|BE mux=H1 flags=HTX|NO_UPG
@@ -23652,6 +23658,10 @@ <h2 id="chapter-5.2" data-target="5.2"><small><a class="small" href="#5.2">5.2.<
2365223658
instance, if &quot;proto h1&quot; is set, the ALPN should not be set to &quot;h2&quot;.
2365323659

2365423660
See also &quot;<a href="#ws">ws</a>&quot; to use an alternative protocol for websocket streams.
23661+
23662+
QMux is a subset of QUIC which runs over TCP. It corresponds to the following
23663+
draft protocol https://www.ietf.org/archive/id/draft-opik-quic-qmux-01.html.
23664+
It is considered experimental in haproxy for now.
2365523665
</pre><a class="anchor" name="quic-cc-algo"></a><a class="anchor" name="5-quic-cc-algo"></a><a class="anchor" name="5.2-quic-cc-algo"></a><a class="anchor" name="quic-cc-algo (Bind and server options)"></a><a class="anchor" name="quic-cc-algo (Server and default-server options)"></a><div class="keyword"><b><a class="anchor" name="quic-cc-algo"></a><a href="#5.2-quic-cc-algo">quic-cc-algo</a></b> <span style="color: #800">{ cubic | newreno | bbr | nocc }</span><span style="color: #008">[(<span style="color: #080">&lt;args,...&gt;</span>)]</span></div><pre class="text">This is a QUIC specific setting to select the congestion control algorithm
2365623666
for any connection targeting this server. They are similar to those used by
2365723667
TCP. See the bind option with a similar name for a complete description of
@@ -35008,14 +35018,19 @@ <h2 id="chapter-12.8" data-target="12.8"><small><a class="small" href="#12.8">12
3500835018
option is independent of the CLI command, so no human intervention
3500935019
is required.
3501035020

35021+
delay - apply an initial wait of &quot;<a href="#dns-delay">dns-delay</a>&quot; before proceeding. Without
35022+
&quot;dns&quot;, the challenge is submitted after the delay expires. When
35023+
combined with &quot;dns&quot;, the initial wait is applied before starting
35024+
the DNS pre-checks.
35025+
3501135026
none - no readiness condition; the challenge is submitted to the ACME
3501235027
server immediately without waiting for any external confirmation.
3501335028
This option cannot be combined with others.
3501435029

35015-
Multiple values can be combined with a comma so that both conditions must be
35016-
met. The order of the values is not significant. When &quot;cli&quot; and &quot;dns&quot; are
35017-
combined, HAProxy first waits for the CLI confirmation before triggering the
35018-
DNS propagation check.
35030+
Multiple values can be combined with a comma. When several conditions are
35031+
specified, HAProxy processes them in the following order: first it waits for
35032+
the CLI confirmation (&quot;cli&quot;), then applies the initial delay (&quot;delay&quot;), then
35033+
performs the DNS pre-checks (&quot;dns&quot;).
3501935034

3502035035
This option is only compatible with the dns-01 challenge type.
3502135036

@@ -35036,9 +35051,20 @@ <h2 id="chapter-12.8" data-target="12.8"><small><a class="small" href="#12.8">12
3503635051
<pre class="prettyprint">
3503735052
<code>directory https://acme-staging-v02.api.letsencrypt.org/directory
3503835053
</code></pre>
35039-
</div><a class="anchor" name="dns-delay"></a><a class="anchor" name="12-dns-delay"></a><a class="anchor" name="12.8-dns-delay"></a><a class="anchor" name="dns-delay (Other sections)"></a><a class="anchor" name="dns-delay (ACME)"></a><div class="keyword"><b><a class="anchor" name="dns-delay"></a><a href="#12.8-dns-delay">dns-delay</a></b> <span style="color: #080">&lt;time&gt;</span></div><pre class="text">When &quot;<a href="#challenge-ready">challenge-ready</a>&quot; includes &quot;dns&quot;, configure the delay before the first
35040-
DNS resolution attempt and between retries. The value is a time expressed in
35041-
HAProxy time format (e.g. &quot;5m&quot;, &quot;300s&quot;). Default is 300 seconds.
35054+
</div><a class="anchor" name="dns-delay"></a><a class="anchor" name="12-dns-delay"></a><a class="anchor" name="12.8-dns-delay"></a><a class="anchor" name="dns-delay (Other sections)"></a><a class="anchor" name="dns-delay (ACME)"></a><div class="keyword"><b><a class="anchor" name="dns-delay"></a><a href="#12.8-dns-delay">dns-delay</a></b> <span style="color: #080">&lt;time&gt;</span></div><pre class="text">Configure the delay used by &quot;<a href="#challenge-ready">challenge-ready</a>&quot; conditions &quot;delay&quot; and &quot;dns&quot;.
35055+
The value is a time expressed in HAProxy time format (e.g. &quot;5m&quot;, &quot;300s&quot;).
35056+
Default is 30 seconds.
35057+
35058+
Its role depends on the &quot;<a href="#challenge-ready">challenge-ready</a>&quot; conditions in use:
35059+
35060+
delay - the challenge is submitted after this delay expires, without
35061+
any DNS pre-check.
35062+
35063+
dns - the delay between two consecutive DNS resolution attempts.
35064+
The first probe fires immediately without any initial wait.
35065+
35066+
dns+delay - the initial wait before the first DNS resolution attempt, and
35067+
the delay between subsequent retries.
3504235068

3504335069
Note that the resolution goes through the configured &quot;default&quot; resolvers
3504435070
section, not the authoritative name servers. Results may therefore still be
@@ -35048,9 +35074,11 @@ <h2 id="chapter-12.8" data-target="12.8"><small><a class="small" href="#12.8">12
3504835074
is a time expressed in HAProxy time format (e.g. &quot;10m&quot;, &quot;600s&quot;). Default is
3504935075
600 seconds.
3505035076

35051-
If the next DNS resolution attempt would be triggered after the timeout has
35052-
elapsed (taking into account &quot;<a href="#dns-delay">dns-delay</a>&quot;), the challenge is aborted with an
35053-
error. This prevents an infinite retry loop when DNS propagation fails.
35077+
The timer starts from the moment the first DNS resolution attempt is
35078+
triggered (after the initial &quot;<a href="#dns-delay">dns-delay</a>&quot;). If the next resolution attempt
35079+
would be triggered after the timeout has elapsed, the challenge is aborted
35080+
with an error. This prevents an infinite retry loop when DNS propagation
35081+
fails.
3505435082
</pre><div class="page-header"><b>See also:</b> &quot;<a href="#dns-delay">dns-delay</a>&quot;</div>
3505535083
<a class="anchor" name="keytype"></a><a class="anchor" name="12-keytype"></a><a class="anchor" name="12.8-keytype"></a><a class="anchor" name="keytype (Other sections)"></a><a class="anchor" name="keytype (ACME)"></a><div class="keyword"><b><a class="anchor" name="keytype"></a><a href="#12.8-keytype">keytype</a></b> <span style="color: #080">&lt;string&gt;</span></div><pre class="text">Configure the type of key that will be generated. Value can be either &quot;RSA&quot;
3505635084
or &quot;ECDSA&quot;. You can also configure the &quot;<span class="dropdown"><a class="dropdown-toggle" data-toggle="dropdown" href="#">curves<span class="caret"></span></a><ul class="dropdown-menu"><li class="dropdown-header">This keyword is available in sections :</li><li><a href="#curves%20%28Load%20options%29">Load options</a></li><li><a href="#curves%20%28ACME%29">ACME</a></li><li><a href="#curves%20%28Bind%20options%29">Bind options</a></li><li><a href="#curves%20%28Server%20and%20default-server%20options%29">Server and default-server options</a></li></ul></span>&quot; for ECDSA and the number of
@@ -35156,7 +35184,7 @@ <h2 id="chapter-12.9" data-target="12.9"><small><a class="small" href="#12.9">12
3515635184
<br>
3515735185
<hr>
3515835186
<div class="text-right">
35159-
HAProxy 3.4-dev7-110 &ndash; Configuration Manual<br>
35187+
HAProxy 3.4-dev7-147 &ndash; Configuration Manual<br>
3516035188
<small>, 2026/03/20</small>
3516135189
</div>
3516235190
</div>

‎docs/dev/intro.html‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<html lang="en">
33
<head>
44
<meta charset="utf-8" />
5-
<title>HAProxy version 3.4-dev7-110 - Starter Guide</title>
5+
<title>HAProxy version 3.4-dev7-147 - Starter Guide</title>
66
<link href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" />
77
<link href="https://raw.githubusercontent.com/thomaspark/bootswatch/v3.3.7/cerulean/bootstrap.min.css" rel="stylesheet" />
88
<link href="../css/page.css?0.4.2-15" rel="stylesheet" />
@@ -484,7 +484,7 @@
484484
You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br>
485485
</p>
486486
<p class="text-right">
487-
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/04/01</b></small>
487+
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/04/02</b></small>
488488
</p>
489489
</div>
490490
<!-- /.sidebar -->
@@ -495,7 +495,7 @@
495495
<div class="text-center">
496496
<h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1>
497497
<h2>Starter Guide</h2>
498-
<p><strong>version 3.4-dev7-110</strong></p>
498+
<p><strong>version 3.4-dev7-147</strong></p>
499499
<p>
500500
<br>
501501

@@ -2515,7 +2515,7 @@ <h2 id="chapter-4.4" data-target="4.4"><small><a class="small" href="#4.4">4.4.<
25152515
<br>
25162516
<hr>
25172517
<div class="text-right">
2518-
HAProxy 3.4-dev7-110 &ndash; Starter Guide<br>
2518+
HAProxy 3.4-dev7-147 &ndash; Starter Guide<br>
25192519
<small>, </small>
25202520
</div>
25212521
</div>

‎docs/dev/management.html‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<html lang="en">
33
<head>
44
<meta charset="utf-8" />
5-
<title>HAProxy version 3.4-dev7-110 - Management Guide</title>
5+
<title>HAProxy version 3.4-dev7-147 - Management Guide</title>
66
<link href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" />
77
<link href="https://raw.githubusercontent.com/thomaspark/bootswatch/v3.3.7/cerulean/bootstrap.min.css" rel="stylesheet" />
88
<link href="../css/page.css?0.4.2-15" rel="stylesheet" />
@@ -696,7 +696,7 @@
696696
You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br>
697697
</p>
698698
<p class="text-right">
699-
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/04/01</b></small>
699+
<small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/04/02</b></small>
700700
</p>
701701
</div>
702702
<!-- /.sidebar -->
@@ -707,7 +707,7 @@
707707
<div class="text-center">
708708
<h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1>
709709
<h2>Management Guide</h2>
710-
<p><strong>version 3.4-dev7-110</strong></p>
710+
<p><strong>version 3.4-dev7-147</strong></p>
711711
<p>
712712
<br>
713713

@@ -5849,7 +5849,7 @@ <h2 id="chapter-13.1" data-target="13.1"><small><a class="small" href="#13.1">13
58495849
<br>
58505850
<hr>
58515851
<div class="text-right">
5852-
HAProxy 3.4-dev7-110 &ndash; Management Guide<br>
5852+
HAProxy 3.4-dev7-147 &ndash; Management Guide<br>
58535853
<small>, </small>
58545854
</div>
58555855
</div>

0 commit comments

Comments
 (0)