mirror of https://github.com/hyperledger/besu
An enterprise-grade Java-based, Apache 2.0 licensed Ethereum client https://wiki.hyperledger.org/display/besu
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
49 lines
1.8 KiB
49 lines
1.8 KiB
6 years ago
|
# Using a Configuration File
|
||
|
|
|
||
|
|
To specify command line options in a file, use a TOML configuration file.
|
||
|
|
|
||
|
|
The configuration file can be saved and reused across node startups. To specify the configuration file,
|
||
|
|
use the [`--config` option](../Reference/Pantheon-CLI-Syntax.md#config).
|
||
|
|
|
||
|
|
To override an option specified in the configuration file, specify the same option on the command line.
|
||
|
|
When an option is specified in both places, Pantheon is started with the command line value.
|
||
|
|
|
||
|
|
## TOML Specification
|
||
|
|
|
||
|
|
The configuration file must be a valid TOML file and is composed of key/value pairs. Each key is the
|
||
|
|
same as the corresponding command line option name without the leading dashes (`--`).
|
||
|
|
|
||
|
|
Values must be be specified according to TOML specifications for string, numbers, arrays, and booleans.
|
||
|
|
Specific differences between the command line and the TOML file format are:
|
||
|
|
|
||
|
|
* Comma-separated lists on the command line are string arrays in the TOML file
|
||
|
|
* File paths, hexadecimal numbers, URLs, and <host:port> values must be enclosed in quotes.
|
||
|
|
|
||
|
|
!!!tip
|
||
|
|
The [command line reference](../Reference/Pantheon-CLI-Syntax.md) includes configuration file examples for each option.
|
||
|
|
|
||
|
|
!!!example "Example TOML configuration file"
|
||
|
|
```toml
|
||
|
|
# Valid TOML config file
|
||
|
|
datadir="~/pantheondata" # Path
|
||
|
|
|
||
|
|
# Network
|
||
|
|
bootnodes=["enode://001@123:4567", "enode://002@123:4567", "enode://003@123:4567"]
|
||
|
|
p2p-listen="1.2.3.4:1234" # IP:port
|
||
|
|
max-peers=42
|
||
|
|
rpc-listen="5.6.7.8:5678" # IP:port
|
||
|
|
ws-listen="9.10.11.12:9101" # IP:port
|
||
|
|
|
||
|
|
# Chain
|
||
|
|
genesis="~/genesis.json" # Path to the custom genesis file
|
||
|
|
|
||
|
|
# Mining
|
||
|
|
miner-enabled=true
|
||
|
|
miner-coinbase="0xfe3b557e8fb62b89f4916b721be55ceb828dbd73"
|
||
|
|
```
|
||
|
|
|
||
|
|
!!!example "Starting Pantheon with a Configuration File"
|
||
|
|
```bash
|
||
|
|
pantheon --config=/home/me/me_node/config.toml
|
||
|
|
```
|