docs: Swarm.EnableHolePunching

ipfs · Nov 24, 2021 · 35ce9ea · 35ce9ea
1 parent 4be3661
commit 35ce9ea
Showing 1 changed file with 16 additions and 0 deletions.
diff --git a/docs/config.md b/docs/config.md
@@ -99,6 +99,7 @@ config file at runtime.
     - [`Swarm.AddrFilters`](#swarmaddrfilters)
     - [`Swarm.DisableBandwidthMetrics`](#swarmdisablebandwidthmetrics)
     - [`Swarm.DisableNatPortMap`](#swarmdisablenatportmap)
+    - [`Swarm.EnableHolePunching`](#swarmenableholepunching)
     - [`Swarm.DisableRelay`](#swarmdisablerelay)
     - [`Swarm.EnableRelayHop`](#swarmenablerelayhop)
     - [`Swarm.EnableAutoRelay`](#swarmenableautorelay)
@@ -1268,6 +1269,21 @@ Default: `false`
 
 Type: `bool`
 
+### `Swarm.EnableHolePunching`
+
+Enable hole punching for NAT traversal
+when port forwarding is not possible.
+
+When enabled, go-ipfs will coordinate with the counterparty using
+a [relayed connection](https://github.com/libp2p/specs/blob/master/relay/circuit-v2.md),
+to [upgrade to a direct connection](https://github.com/libp2p/specs/blob/master/relay/DCUtR.md)
+through a NAT/firewall whenever possible.
+For good results, use with `RelayClient.Enabled` set to `true`.
+
+Default: `false`
+
+Type: `flag`
+
 ### `Swarm.DisableRelay`
 
 Deprecated: Set `Swarm.Transports.Network.Relay` to `false`.