diff --git a/docs/_interface/peer-to-peer.md b/docs/_interface/peer-to-peer.md index ba38939f4..f56aad311 100644 --- a/docs/_interface/peer-to-peer.md +++ b/docs/_interface/peer-to-peer.md @@ -3,6 +3,25 @@ title: Connecting To The Network sort_key: B --- +If you start geth without any flags, it will connect to the Ethereum mainnet. In addition to +the mainnet, geth recognizes a few testnets which you can connect to via the respective flags: + +- `--ropsten`, Ropsten proof-of-work test network +- `--rinkeby`, Rinkeby proof-of-authority test network +- `--goerli`, Goerli proof-of-authority test network + +**Note:** network selection is not persisted in the config file. To connect to a pre-defined network +you must always enable it explicitly, even when using the `--config` flag to load other configuration values. +For example: + +```sh +# Generate desired config file. You must specify testnet here. +geth --goerli --syncmode "full" ... dumpconfig > goerli.toml + +# Start geth with given config file. Here too the testnet must be specified. +geth --goerli --config goerli.toml +``` + ## How Peers Are Found Geth continuously attempts to connect to other nodes on the network until it has peers. If @@ -162,4 +181,4 @@ Nodes can be added using the `admin.addTrustedPeer()` RPC-call over the js conso ```js admin.addTrustedPeer("enode://f4642fa65af50cfdea8fa7414a5def7bb7991478b768e296f5e4a54e8b995de102e0ceae2e826f293c481b5325f89be6d207b003382e18a8ecba66fbaf6416c0@33.4.2.1:30303") -``` \ No newline at end of file +```