From 6b76ff0ca03bda69dc113e6f285a1f57a12577c4 Mon Sep 17 00:00:00 2001
From: Hector Sanjuan <code@hector.link>
Date: Fri, 6 Jun 2025 22:51:54 +0200
Subject: [PATCH] docs/env variables: Document LIBP2P_SWARM_FD_LIMIT

---
 docs/environment-variables.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/environment-variables.md b/docs/environment-variables.md
index 2b763721b..ed18f8f3b 100644
--- a/docs/environment-variables.md
+++ b/docs/environment-variables.md
@@ -23,6 +23,7 @@
   - [`LIBP2P_MUX_PREFS`](#libp2p_mux_prefs)
   - [`LIBP2P_RCMGR`](#libp2p_rcmgr)
   - [`LIBP2P_DEBUG_RCMGR`](#libp2p_debug_rcmgr)
+  - [`LIBP2P_SWARM_FD_LIMIT`](#libp2p_swarm_fd_limit)
 - [Tracing](#tracing)
 
 # Variables
@@ -235,6 +236,14 @@ and outputs it to `rcmgr.json.gz`
 
 Default: disabled (not set)
 
+## `LIBP2P_SWARM_FD_LIMIT`
+
+This variable controls the number of concurrent outbound dials (except dials to relay addresses which have their own limiting logic).
+
+Reducing it slows down connection ballooning but might affect performance negatively.
+
+Default: [160](https://github.com/libp2p/go-libp2p/blob/master/p2p/net/swarm/swarm_dial.go#L91) (not set)
+
 # Tracing
 
 For tracing configuration, please check: https://github.com/ipfs/boxo/blob/main/docs/tracing.md
-- 
GitLab