docs: add section about config file and network selection flags (#23146)

Co-authored-by: Felix Lange <fjl@twurst.com>
This commit is contained in:
Sina Mahmoodi 2021-07-02 10:14:45 +02:00 committed by GitHub
parent 81c328ed38
commit 7cc2a04447
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 20 additions and 1 deletions

View File

@ -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