diff --git a/doc/manual/rl-next/substituter-timeout.md b/doc/manual/rl-next/substituter-timeout.md
new file mode 100644
index 000000000..78f59590b
--- /dev/null
+++ b/doc/manual/rl-next/substituter-timeout.md
@@ -0,0 +1,7 @@
+---
+synopsis: "Reduce connect timeout for http substituter"
+issues:
+prs: [12876]
+---
+
+Previously, the Nix setting `connect-timeout` had no limit. It is now set to `5s`, offering a more practical default for users self-hosting binary caches, which may occasionally become unavailable, such as during updates.