Skip to content

Commit

Permalink
Merge pull request #498 from ethersphere/add-neighborhoods-api-note
Browse files Browse the repository at this point in the history
added recommendation to set target neighborhood
  • Loading branch information
NoahMaizels authored Oct 11, 2023
2 parents 34f66f2 + 56f7b96 commit c369040
Showing 1 changed file with 8 additions and 0 deletions.
8 changes: 8 additions & 0 deletions docs/bee/installation/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -289,6 +289,14 @@ resolver-options: ["https://mainnet.infura.io/v3/<<your-api-key>>"]
```
### 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:
Expand Down

0 comments on commit c369040

Please sign in to comment.