diff --git a/docs/bee/installation/install.md b/docs/bee/installation/install.md index 821a5c4a2..60157fb6b 100644 --- a/docs/bee/installation/install.md +++ b/docs/bee/installation/install.md @@ -289,6 +289,14 @@ resolver-options: ["https://mainnet.infura.io/v3/<>"] ``` +### Set Target Neighborhood (Optional) + +When setting up a new Bee node, a randomly generated overlay address will determine the node's [neighborhood](/docs/learn/technology/disc#neighborhoods). By using the `target-neighborhood` config option, however, an overlay address will be generated which falls within a specific neighborhood. There are two good reasons for doing this. First, by choosing a lesser populated neighborhood, a node's chances of winning rewards can be increased. Second, choosing to set up a node in a less populated neighborhood will strengthen the resiliency of the Swarm network. Therefore it is recommended to use the `target-neighborhood` option. + +To use this option, it's first necessary to identify potential target neighborhoods. A convenient tool for finding underpopulated neighborhoods is available at the [Swarmscan website](https://swarmscan.io/neighborhoods). This tool returns the leading bits of target neighborhoods in order of least populated to most. Simply copy the leading bits from one of the least populated neighborhoods and use it to set `target-neighborhood`. After doing so, an overlay address within that neighborhood will be generated when starting Bee for the first time. + +See the [staking page](/docs/bee/working-with-bee/staking) for more information. + ## 3. Find Bee address As part of the process of starting a Bee full node or light node the node must issue a Gnosis Chain transaction which is paid for using xDAI. We therefore need to find our node's Gnosis Chain address. We can find it by reading it directly from our key file: