tendermint/docs/spec/p2p/config.md

39 lines
1.3 KiB
Markdown
Raw Normal View History

2018-01-01 12:59:53 -08:00
# P2P Config
Here we describe configuration options around the Peer Exchange.
2018-01-24 21:02:26 -08:00
These can be set using flags or via the `$TMHOME/config/config.toml` file.
2018-01-01 12:59:53 -08:00
## Seed Mode
`--p2p.seed_mode`
2018-01-09 09:44:49 -08:00
The node operates in seed mode. In seed mode, a node continuously crawls the network for peers,
and upon incoming connection shares some peers and disconnects.
2018-01-01 12:59:53 -08:00
## Seeds
`--p2p.seeds “1.2.3.4:26656,2.3.4.5:4444”`
2018-01-01 12:59:53 -08:00
2018-01-09 09:44:49 -08:00
Dials these seeds when we need more peers. They should return a list of peers and then disconnect.
2018-01-01 12:59:53 -08:00
If we already have enough peers in the address book, we may never need to dial them.
## Persistent Peers
`--p2p.persistent_peers “1.2.3.4:26656,2.3.4.5:26656”`
2018-01-01 12:59:53 -08:00
Dial these peers and auto-redial them if the connection fails.
These are intended to be trusted persistent peers that can help
2018-01-24 21:02:26 -08:00
anchor us in the p2p network. The auto-redial uses exponential
backoff and will give up after a day of trying to connect.
2018-01-01 12:59:53 -08:00
2018-01-24 21:02:26 -08:00
**Note:** If `seeds` and `persistent_peers` intersect,
the user will be warned that seeds may auto-close connections
and that the node may not be able to keep the connection persistent.
2018-01-01 12:59:53 -08:00
## Private Persistent Peers
`--p2p.private_persistent_peers “1.2.3.4:26656,2.3.4.5:26656”`
2018-01-01 12:59:53 -08:00
These are persistent peers that we do not add to the address book or
gossip to other peers. They stay private to us.