From ec12c2f051f94df6f4c86175caddc0d1108254cd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Hoguin?= <essen@ninenines.eu>
Date: Tue, 16 Jan 2024 13:11:38 +0100
Subject: Recommend increasing max_frame_size_received HTTP/2 option

---
 doc/src/manual/cowboy_http2.asciidoc | 6 ++++++
 1 file changed, 6 insertions(+)

(limited to 'doc/src/manual/cowboy_http2.asciidoc')

diff --git a/doc/src/manual/cowboy_http2.asciidoc b/doc/src/manual/cowboy_http2.asciidoc
index 8977c3c..6af4fc0 100644
--- a/doc/src/manual/cowboy_http2.asciidoc
+++ b/doc/src/manual/cowboy_http2.asciidoc
@@ -173,6 +173,12 @@ max_frame_size_received (16384)::
 Maximum size in bytes of the frames received by the server. This value is
 advertised to the remote endpoint which can then decide to use
 any value lower or equal for its frame sizes.
++
+It is highly recommended to increase this value for performance reasons.
+In a future Cowboy version the default will be increased to 1MB (1048576).
+Too low values may result in very large file uploads failing because
+Cowboy will detect the large number of frames as flood and close the
+connection.
 
 max_frame_size_sent (infinity)::
 
-- 
cgit v1.2.3

