docs: update CLI options from latest geth --help output (#31835)

Replaced outdated command-line options documentation with the latest
stable output from `geth --help` to reflect current Geth usage. This
ensures accuracy for users referencing CLI flags.
This commit is contained in:
Dlordkendex 2025-05-16 09:11:25 +01:00 committed by GitHub
parent 24e04b3eb7
commit 391d117f19
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -24,10 +24,10 @@ NAME:
geth - the go-ethereum command line interface geth - the go-ethereum command line interface
USAGE: USAGE:
geth [global options] command [command options] [arguments...] geth [global options] command [command options]
VERSION: VERSION:
1.13.1-stable-3f40e65c 1.15.11-stable-36b2371c
COMMANDS: COMMANDS:
account Manage accounts account Manage accounts
@ -38,12 +38,14 @@ COMMANDS:
dumpconfig Export configuration values in a TOML format dumpconfig Export configuration values in a TOML format
dumpgenesis Dumps genesis block JSON configuration to stdout dumpgenesis Dumps genesis block JSON configuration to stdout
export Export blockchain into file export Export blockchain into file
export-preimages Export the preimage database into an RLP stream export-history Export blockchain history to Era archives
import Import a blockchain file import Import a blockchain file
import-history Import an Era archive
import-preimages Import the preimage database from an RLP stream import-preimages Import the preimage database from an RLP stream
init Bootstrap and initialize a new genesis block init Bootstrap and initialize a new genesis block
js (DEPRECATED) Execute the specified JavaScript files js (DEPRECATED) Execute the specified JavaScript files
license Display license information license Display license information
prune-history Prune blockchain history (block bodies and receipts) up to the merge block
removedb Remove blockchain and state databases removedb Remove blockchain and state databases
show-deprecated-flags Show flags that have been deprecated show-deprecated-flags Show flags that have been deprecated
snapshot A set of commands based on the snapshot snapshot A set of commands based on the snapshot
@ -54,16 +56,9 @@ COMMANDS:
help, h Shows a list of commands or help for one command help, h Shows a list of commands or help for one command
GLOBAL OPTIONS: GLOBAL OPTIONS:
--log.rotate (default: false) ($GETH_LOG_ROTATE)
Enables log file rotation
ACCOUNT ACCOUNT
--allow-insecure-unlock (default: false) ($GETH_ALLOW_INSECURE_UNLOCK)
Allow insecure account unlocking when account-related RPCs are exposed by http
--keystore value ($GETH_KEYSTORE) --keystore value ($GETH_KEYSTORE)
Directory for the keystore (default = inside the datadir) Directory for the keystore (default = inside the datadir)
@ -79,28 +74,72 @@ GLOBAL OPTIONS:
--signer value ($GETH_SIGNER) --signer value ($GETH_SIGNER)
External signer (url or path to ipc file) External signer (url or path to ipc file)
--unlock value ($GETH_UNLOCK)
Comma separated list of accounts to unlock
--usb (default: false) ($GETH_USB) --usb (default: false) ($GETH_USB)
Enable monitoring and management of USB hardware wallets Enable monitoring and management of USB hardware wallets
ALIASED (deprecated) ALIASED (deprecated)
--allow-insecure-unlock (default: false) ($GETH_ALLOW_INSECURE_UNLOCK)
Allow insecure account unlocking when account-related RPCs are exposed by http
(deprecated)
--cache.trie.journal value ($GETH_CACHE_TRIE_JOURNAL) --cache.trie.journal value ($GETH_CACHE_TRIE_JOURNAL)
Disk journal directory for trie cache to survive node restarts Disk journal directory for trie cache to survive node restarts
--cache.trie.rejournal value (default: 0s) ($GETH_CACHE_TRIE_REJOURNAL) --cache.trie.rejournal value (default: 0s) ($GETH_CACHE_TRIE_REJOURNAL)
Time interval to regenerate the trie cache journal Time interval to regenerate the trie cache journal
--light.egress value (default: 0) ($GETH_LIGHT_EGRESS)
Outgoing bandwidth limit for serving light clients (deprecated)
--light.ingress value (default: 0) ($GETH_LIGHT_INGRESS)
Incoming bandwidth limit for serving light clients (deprecated)
--light.maxpeers value (default: 0) ($GETH_LIGHT_MAXPEERS)
Maximum number of light clients to serve, or light servers to attach to
(deprecated)
--light.nopruning (default: false) ($GETH_LIGHT_NOPRUNING)
Disable ancient light chain data pruning (deprecated)
--light.nosyncserve (default: false) ($GETH_LIGHT_NOSYNCSERVE)
Enables serving light clients before syncing (deprecated)
--light.serve value (default: 0) ($GETH_LIGHT_SERVE)
Maximum percentage of time allowed for serving LES requests (deprecated)
--log.backtrace value ($GETH_LOG_BACKTRACE)
Request a stack trace at a specific logging statement (deprecated)
--log.debug (default: false) ($GETH_LOG_DEBUG)
Prepends log messages with call-site location (deprecated)
--metrics.expensive (default: false) ($GETH_METRICS_EXPENSIVE)
Enable expensive metrics collection and reporting (deprecated)
--mine (default: false) ($GETH_MINE)
Enable mining (deprecated)
--miner.etherbase value ($GETH_MINER_ETHERBASE)
0x prefixed public address for block mining rewards (deprecated)
--miner.newpayload-timeout value (default: 2s) ($GETH_MINER_NEWPAYLOAD_TIMEOUT)
Specify the maximum time allowance for creating a new payload (deprecated)
--nousb (default: false) ($GETH_NOUSB) --nousb (default: false) ($GETH_NOUSB)
Disables monitoring for and managing USB hardware wallets (deprecated) Disables monitoring for and managing USB hardware wallets (deprecated)
--rpc.enabledeprecatedpersonal (default: false) ($GETH_RPC_ENABLEDEPRECATEDPERSONAL)
This used to enable the 'personal' namespace.
--txlookuplimit value (default: 2350000) ($GETH_TXLOOKUPLIMIT) --txlookuplimit value (default: 2350000) ($GETH_TXLOOKUPLIMIT)
Number of recent blocks to maintain transactions index for (default = about one Number of recent blocks to maintain transactions index for (default = about one
year, 0 = entire chain) (deprecated, use history.transactions instead) year, 0 = entire chain) (deprecated, use history.transactions instead)
--unlock value ($GETH_UNLOCK)
Comma separated list of accounts to unlock (deprecated)
--v5disc (default: false) ($GETH_V5DISC) --v5disc (default: false) ($GETH_V5DISC)
Enables the experimental RLPx V5 (Topic Discovery) mechanism (deprecated, use Enables the experimental RLPx V5 (Topic Discovery) mechanism (deprecated, use
--discv5 instead) --discv5 instead)
@ -140,7 +179,7 @@ GLOBAL OPTIONS:
Comma separated list of virtual hostnames from which to accept requests (server Comma separated list of virtual hostnames from which to accept requests (server
enforced). Accepts '*' wildcard. enforced). Accepts '*' wildcard.
--header value, -H value --header value, -H value ($GETH_HEADER)
Pass custom headers to the RPC server when using --remotedb or the geth attach Pass custom headers to the RPC server when using --remotedb or the geth attach
console. This flag can be given multiple times. console. This flag can be given multiple times.
@ -161,8 +200,7 @@ GLOBAL OPTIONS:
HTTP-RPC server listening port HTTP-RPC server listening port
--http.rpcprefix value ($GETH_HTTP_RPCPREFIX) --http.rpcprefix value ($GETH_HTTP_RPCPREFIX)
HTTP path path prefix on which JSON-RPC is served. Use '/' to serve on all HTTP path prefix on which JSON-RPC is served. Use '/' to serve on all paths.
paths.
--http.vhosts value (default: "localhost") ($GETH_HTTP_VHOSTS) --http.vhosts value (default: "localhost") ($GETH_HTTP_VHOSTS)
Comma separated list of virtual hostnames from which to accept requests (server Comma separated list of virtual hostnames from which to accept requests (server
@ -189,16 +227,13 @@ GLOBAL OPTIONS:
--rpc.batch-response-max-size value (default: 25000000) ($GETH_RPC_BATCH_RESPONSE_MAX_SIZE) --rpc.batch-response-max-size value (default: 25000000) ($GETH_RPC_BATCH_RESPONSE_MAX_SIZE)
Maximum number of bytes returned from a batched call Maximum number of bytes returned from a batched call
--rpc.enabledeprecatedpersonal (default: false) ($GETH_RPC_ENABLEDEPRECATEDPERSONAL)
Enables the (deprecated) personal namespace
--rpc.evmtimeout value (default: 5s) ($GETH_RPC_EVMTIMEOUT) --rpc.evmtimeout value (default: 5s) ($GETH_RPC_EVMTIMEOUT)
Sets a timeout used for eth_call (0=infinite) Sets a timeout used for eth_call (0=infinite)
--rpc.gascap value (default: 50000000) ($GETH_RPC_GASCAP) --rpc.gascap value (default: 50000000) ($GETH_RPC_GASCAP)
Sets a cap on gas that can be used in eth_call/estimateGas (0=infinite) Sets a cap on gas that can be used in eth_call/estimateGas (0=infinite)
--rpc.txfeecap value (default: 1) --rpc.txfeecap value (default: 1) ($GETH_RPC_TXFEECAP)
Sets a cap on transaction fee (in ether) that can be sent via the RPC APIs (0 = Sets a cap on transaction fee (in ether) that can be sent via the RPC APIs (0 =
no cap) no cap)
@ -220,6 +255,37 @@ GLOBAL OPTIONS:
--ws.rpcprefix value ($GETH_WS_RPCPREFIX) --ws.rpcprefix value ($GETH_WS_RPCPREFIX)
HTTP path prefix on which JSON-RPC is served. Use '/' to serve on all paths. HTTP path prefix on which JSON-RPC is served. Use '/' to serve on all paths.
BEACON CHAIN
--beacon.api value ($GETH_BEACON_API)
Beacon node (CL) light client API URL. This flag can be given multiple times.
--beacon.api.header value ($GETH_BEACON_API_HEADER)
Pass custom HTTP header fields to the remote beacon node API in "key:value"
format. This flag can be given multiple times.
--beacon.checkpoint value ($GETH_BEACON_CHECKPOINT)
Beacon chain weak subjectivity checkpoint block hash
--beacon.checkpoint.file value ($GETH_BEACON_CHECKPOINT_FILE)
Beacon chain weak subjectivity checkpoint import/export file
--beacon.config value ($GETH_BEACON_CONFIG)
Beacon chain config YAML file
--beacon.genesis.gvroot value ($GETH_BEACON_GENESIS_GVROOT)
Beacon chain genesis validators root
--beacon.genesis.time value (default: 0) ($GETH_BEACON_GENESIS_TIME)
Beacon chain genesis time
--beacon.nofilter (default: false) ($GETH_BEACON_NOFILTER)
Disable future slot signature filter
--beacon.threshold value (default: 342) ($GETH_BEACON_THRESHOLD)
Beacon sync committee participation threshold
DEVELOPER CHAIN DEVELOPER CHAIN
@ -236,9 +302,6 @@ GLOBAL OPTIONS:
ETHEREUM ETHEREUM
--bloomfilter.size value (default: 2048) ($GETH_BLOOMFILTER_SIZE)
Megabytes of memory allocated to bloom-filter for pruning
--config value ($GETH_CONFIG) --config value ($GETH_CONFIG)
TOML configuration file TOML configuration file
@ -262,21 +325,21 @@ GLOBAL OPTIONS:
--exitwhensynced (default: false) ($GETH_EXITWHENSYNCED) --exitwhensynced (default: false) ($GETH_EXITWHENSYNCED)
Exits after block synchronisation completes Exits after block synchronisation completes
--goerli (default: false) ($GETH_GOERLI)
Görli network: pre-configured proof-of-authority test network
--holesky (default: false) ($GETH_HOLESKY) --holesky (default: false) ($GETH_HOLESKY)
Holesky network: pre-configured proof-of-stake test network Holesky network: pre-configured proof-of-stake test network
--hoodi (default: false) ($GETH_HOODI)
Hoodi network: pre-configured proof-of-stake test network
--mainnet (default: false) ($GETH_MAINNET) --mainnet (default: false) ($GETH_MAINNET)
Ethereum mainnet Ethereum mainnet
--networkid value (default: 1) ($GETH_NETWORKID) --networkid value (default: 0) ($GETH_NETWORKID)
Explicitly set network id (integer)(For testnets: use --goerli, --sepolia, Explicitly set network id (integer)(For testnets: use --sepolia, --holesky,
--holesky instead) --hoodi instead)
--override.cancun value (default: 0) ($GETH_OVERRIDE_CANCUN) --override.prague value (default: 0) ($GETH_OVERRIDE_PRAGUE)
Manually specify the Cancun fork timestamp, overriding the bundled setting Manually specify the Prague fork timestamp, overriding the bundled setting
--override.verkle value (default: 0) ($GETH_OVERRIDE_VERKLE) --override.verkle value (default: 0) ($GETH_OVERRIDE_VERKLE)
Manually specify the Verkle fork timestamp, overriding the bundled setting Manually specify the Verkle fork timestamp, overriding the bundled setting
@ -293,10 +356,10 @@ GLOBAL OPTIONS:
--gpo.blocks value (default: 20) ($GETH_GPO_BLOCKS) --gpo.blocks value (default: 20) ($GETH_GPO_BLOCKS)
Number of recent blocks to check for gas prices Number of recent blocks to check for gas prices
--gpo.ignoreprice value (default: 2) --gpo.ignoreprice value (default: 2) ($GETH_GPO_IGNOREPRICE)
Gas price below which gpo will ignore transactions Gas price below which gpo will ignore transactions
--gpo.maxprice value (default: 500000000000) --gpo.maxprice value (default: 500000000000) ($GETH_GPO_MAXPRICE)
Maximum transaction priority fee (or gasprice before London fork) to be Maximum transaction priority fee (or gasprice before London fork) to be
recommended by gpo recommended by gpo
@ -304,42 +367,15 @@ GLOBAL OPTIONS:
Suggested gas price is the given percentile of a set of recent transaction gas Suggested gas price is the given percentile of a set of recent transaction gas
prices prices
LIGHT CLIENT
--light.egress value (default: 0) ($GETH_LIGHT_EGRESS)
Outgoing bandwidth limit for serving light clients (kilobytes/sec, 0 =
unlimited)
--light.ingress value (default: 0) ($GETH_LIGHT_INGRESS)
Incoming bandwidth limit for serving light clients (kilobytes/sec, 0 =
unlimited)
--light.maxpeers value (default: 100) ($GETH_LIGHT_MAXPEERS)
Maximum number of light clients to serve, or light servers to attach to
--light.nopruning (default: false) ($GETH_LIGHT_NOPRUNING)
Disable ancient light chain data pruning
--light.nosyncserve (default: false) ($GETH_LIGHT_NOSYNCSERVE)
Enables serving light clients before syncing
--light.serve value (default: 0) ($GETH_LIGHT_SERVE)
Maximum percentage of time allowed for serving LES requests (multi-threaded
processing allows values over 100)
LOGGING AND DEBUGGING LOGGING AND DEBUGGING
--log.backtrace value ($GETH_LOG_BACKTRACE) --go-execution-trace value ($GETH_GO_EXECUTION_TRACE)
Request a stack trace at a specific logging statement (e.g. "block.go:271") Write Go execution trace to the given file
--log.compress (default: false) ($GETH_LOG_COMPRESS) --log.compress (default: false) ($GETH_LOG_COMPRESS)
Compress the log files Compress the log files
--log.debug (default: false) ($GETH_LOG_DEBUG)
Prepends log messages with call-site location (file and line number)
--log.file value ($GETH_LOG_FILE) --log.file value ($GETH_LOG_FILE)
Write logs to a file Write logs to a file
@ -355,13 +391,13 @@ GLOBAL OPTIONS:
--log.maxsize value (default: 100) ($GETH_LOG_MAXSIZE) --log.maxsize value (default: 100) ($GETH_LOG_MAXSIZE)
Maximum size in MBs of a single log file Maximum size in MBs of a single log file
--log.rotate (default: false) ($GETH_LOG_ROTATE)
Enables log file rotation
--log.vmodule value ($GETH_LOG_VMODULE) --log.vmodule value ($GETH_LOG_VMODULE)
Per-module verbosity: comma-separated list of <pattern>=<level> (e.g. Per-module verbosity: comma-separated list of <pattern>=<level> (e.g.
eth/*=5,p2p=4) eth/*=5,p2p=4)
--nocompaction (default: false) ($GETH_NOCOMPACTION)
Disables db compaction after import
--pprof (default: false) ($GETH_PPROF) --pprof (default: false) ($GETH_PPROF)
Enable the pprof HTTP server Enable the pprof HTTP server
@ -383,9 +419,6 @@ GLOBAL OPTIONS:
--remotedb value ($GETH_REMOTEDB) --remotedb value ($GETH_REMOTEDB)
URL for remote database URL for remote database
--trace value ($GETH_TRACE)
Write execution trace to the given file
--verbosity value (default: 3) ($GETH_VERBOSITY) --verbosity value (default: 3) ($GETH_VERBOSITY)
Logging verbosity: 0=silent, 1=error, 2=warn, 3=info, 4=debug, 5=detail Logging verbosity: 0=silent, 1=error, 2=warn, 3=info, 4=debug, 5=detail
@ -401,9 +434,6 @@ GLOBAL OPTIONS:
--metrics.addr value ($GETH_METRICS_ADDR) --metrics.addr value ($GETH_METRICS_ADDR)
Enable stand-alone metrics HTTP server listening interface. Enable stand-alone metrics HTTP server listening interface.
--metrics.expensive (default: false) ($GETH_METRICS_EXPENSIVE)
Enable expensive metrics collection and reporting
--metrics.influxdb (default: false) ($GETH_METRICS_INFLUXDB) --metrics.influxdb (default: false) ($GETH_METRICS_INFLUXDB)
Enable metrics export/push to an external InfluxDB database Enable metrics export/push to an external InfluxDB database
@ -442,23 +472,18 @@ GLOBAL OPTIONS:
MINER MINER
--mine (default: false) ($GETH_MINE)
Enable mining
--miner.etherbase value ($GETH_MINER_ETHERBASE)
0x prefixed public address for block mining rewards
--miner.extradata value ($GETH_MINER_EXTRADATA) --miner.extradata value ($GETH_MINER_EXTRADATA)
Block extra data set by the miner (default = client version) Block extra data set by the miner (default = client version)
--miner.gaslimit value (default: 30000000) ($GETH_MINER_GASLIMIT) --miner.gaslimit value (default: 36000000) ($GETH_MINER_GASLIMIT)
Target gas ceiling for mined blocks Target gas ceiling for mined blocks
--miner.gasprice value (default: 0) ($GETH_MINER_GASPRICE) --miner.gasprice value (default: 1000000) ($GETH_MINER_GASPRICE)
Minimum gas price for mining a transaction Minimum gas price for mining a transaction
--miner.newpayload-timeout value (default: 2s) ($GETH_MINER_NEWPAYLOAD_TIMEOUT) --miner.pending.feeRecipient value ($GETH_MINER_PENDING_FEERECIPIENT)
Specify the maximum time allowance for creating a new payload 0x prefixed public address for the pending block producer (not used for actual
block production)
--miner.recommit value (default: 2s) ($GETH_MINER_RECOMMIT) --miner.recommit value (default: 2s) ($GETH_MINER_RECOMMIT)
Time interval to recreate the block being mined Time interval to recreate the block being mined
@ -470,7 +495,7 @@ GLOBAL OPTIONS:
show help show help
--synctarget value ($GETH_SYNCTARGET) --synctarget value ($GETH_SYNCTARGET)
File for containing the hex-encoded block-rlp as sync target(dev feature) Hash of the block to full sync to (dev testing feature)
--version, -v (default: false) --version, -v (default: false)
print the version print the version
@ -490,8 +515,8 @@ GLOBAL OPTIONS:
--discovery.v4, --discv4 (default: true) ($GETH_DISCOVERY_V4) --discovery.v4, --discv4 (default: true) ($GETH_DISCOVERY_V4)
Enables the V4 discovery mechanism Enables the V4 discovery mechanism
--discovery.v5, --discv5 (default: false) ($GETH_DISCOVERY_V5) --discovery.v5, --discv5 (default: true) ($GETH_DISCOVERY_V5)
Enables the experimental RLPx V5 (Topic Discovery) mechanism Enables the V5 discovery mechanism
--identity value ($GETH_IDENTITY) --identity value ($GETH_IDENTITY)
Custom node name Custom node name
@ -503,7 +528,8 @@ GLOBAL OPTIONS:
Maximum number of pending connection attempts (defaults used if set to 0) Maximum number of pending connection attempts (defaults used if set to 0)
--nat value (default: "any") ($GETH_NAT) --nat value (default: "any") ($GETH_NAT)
NAT port mapping mechanism (any|none|upnp|pmp|pmp:<IP>|extip:<IP>) NAT port mapping mechanism
(any|none|upnp|pmp|pmp:<IP>|extip:<IP>|stun:<IP:PORT>)
--netrestrict value ($GETH_NETRESTRICT) --netrestrict value ($GETH_NETRESTRICT)
Restricts network communication to the given IP networks (CIDR masks) Restricts network communication to the given IP networks (CIDR masks)
@ -565,24 +591,37 @@ GLOBAL OPTIONS:
Blockchain garbage collection mode, only relevant in state.scheme=hash ("full", Blockchain garbage collection mode, only relevant in state.scheme=hash ("full",
"archive") "archive")
--history.chain value (default: "all") ($GETH_HISTORY_CHAIN)
Blockchain history retention ("all" or "postmerge")
--history.logs value (default: 2350000) ($GETH_HISTORY_LOGS)
Number of recent blocks to maintain log search index for (default = about one
year, 0 = entire chain)
--history.logs.disable (default: false) ($GETH_HISTORY_LOGS_DISABLE)
Do not maintain log search index
--history.logs.export value ($GETH_HISTORY_LOGS_EXPORT)
Export checkpoints to file in go source file format
--history.state value (default: 90000) ($GETH_HISTORY_STATE) --history.state value (default: 90000) ($GETH_HISTORY_STATE)
Number of recent blocks to retain state history for (default = 90,000 blocks, 0 Number of recent blocks to retain state history for, only relevant in
= entire chain) state.scheme=path (default = 90,000 blocks, 0 = entire chain)
--history.transactions value (default: 2350000) ($GETH_HISTORY_TRANSACTIONS) --history.transactions value (default: 2350000) ($GETH_HISTORY_TRANSACTIONS)
Number of recent blocks to maintain transactions index for (default = about one Number of recent blocks to maintain transactions index for (default = about one
year, 0 = entire chain) year, 0 = entire chain)
--state.scheme value (default: "hash") ($GETH_STATE_SCHEME) --state.scheme value ($GETH_STATE_SCHEME)
Scheme to use for storing ethereum state ('hash' or 'path') Scheme to use for storing ethereum state ('hash' or 'path')
--syncmode value (default: snap) ($GETH_SYNCMODE) --syncmode value (default: "snap") ($GETH_SYNCMODE)
Blockchain sync mode ("snap", "full" or "light") Blockchain sync mode ("snap" or "full")
TRANSACTION POOL (BLOB) TRANSACTION POOL (BLOB)
--blobpool.datacap value (default: 10737418240) ($GETH_BLOBPOOL_DATACAP) --blobpool.datacap value (default: 2684354560) ($GETH_BLOBPOOL_DATACAP)
Disk space to allocate for pending blob transactions (soft limit) Disk space to allocate for pending blob transactions (soft limit)
--blobpool.datadir value (default: "blobpool") ($GETH_BLOBPOOL_DATADIR) --blobpool.datadir value (default: "blobpool") ($GETH_BLOBPOOL_DATADIR)
@ -633,7 +672,13 @@ GLOBAL OPTIONS:
--vmdebug (default: false) ($GETH_VMDEBUG) --vmdebug (default: false) ($GETH_VMDEBUG)
Record information useful for VM and contract debugging Record information useful for VM and contract debugging
--vmtrace value ($GETH_VMTRACE)
Name of tracer which should record internal VM operations (costly)
--vmtrace.jsonconfig value (default: "{}") ($GETH_VMTRACE_JSONCONFIG)
Tracer configuration (JSON)
COPYRIGHT: COPYRIGHT:
Copyright 2013-2023 The go-ethereum Authors Copyright 2013-2025 The go-ethereum Authors
``` ```