solana cli arguments

solana

cli

args / tags /

2025

account

Load an account from the provided JSON file (see `solana account --help` on how to dump an account to file). Files are searched for relatively to CWD and testsfixtures. If ADDRESS is omitted via the `-` placeholder, the one in the file will be used. If the ledger already exists then this parameter is silently ignored"
account dir

Load all the accounts from the JSON files found in the specified DIRECTORY (see also the `--account` flag). If the ledger already exists then this parameter is silently ignored"
account index exclude key

When account indexes are enabled, exclude this key from the index.
account index include key

When account indexes are enabled, only include specific keys in the index. This overrides --account-index-exclude-key."
account indexes

Enable an accounts index, indexed by the selected account field
account paths

Comma separated persistent accounts location. May be specified multiple times. [default: <LEDGER>accounts]"
account shrink path

Path to accounts shrink path which can hold a compacted account set.
accounts db access storages method

Access account storages using this method
accounts db ancient append vecs

AppendVecs that are older than (slots_per_epoch - SLOT-OFFSET) are squashed together."
accounts db ancient storage ideal size

The smallest size of ideal ancient storage.
accounts db cache limit mb

How large the write cache for account data can become. If this is exceeded, the cache is flushed more aggressively."
accounts db caching enabled

no description available
accounts db clean threads

Number of threads to use for cleaning AccountsDb
accounts db create ancient storage packed

Create ancient storages in one shot instead of appending.
accounts db experimental accumulator hash

Enables the experimental accumulator hash
accounts db hash calculation pubkey bins

The number of pubkey bins used for accounts hash calculation.
accounts db foreground threads

Number of threads to use for AccountsDb block processing
accounts db index hashing

Enables the use of the index in hash calculation in AccountsHashVerifierAccounts Background Service."
accounts db hash threads

Number of threads to use for background accounts hashing
accounts db max ancient storages

The number of ancient storages the ancient slot combining should converge to.
accounts db read cache limit mb

How large the read cache for account data can become, in mebibytes
accounts db scan filter for shrinking

Debug option to use different type of filtering for accounts index scan in shrinking. "all" will scan both in-memory and on-disk accounts index, which is the default. "only-abnormal" will scan in-memory accounts index only for abnormal entries and skip scanning on-disk accounts index by assuming that on-disk accounts index contains only normal accounts index entry. "only-abnormal-with-verify" is similar to "only-abnormal", which will scan in-memory index for abnormal entries, but will also verify that on-disk account entries are indeed normal."
accounts db skip shrink

Disable the disk-based accounts index if it is enabled by default.
accounts db snapshots use experimental accumulator hash

Snapshots use the experimental accumulator hash
accounts db squash storages method

Squash multiple account storage files together using this method
accounts db test hash calculation

Enables testing of hash calculation using stores in AccountsHashVerifier. This has a computational cost."
accounts db test skip rewrites

Debug option to skip rewrites for rent-exempt accounts but still add them in bank delta hash calculation"
accounts db verify experimental accumulator hash

Verifies the experimental accumulator hash
accounts db verify refcounts

Debug option to scan all append vecs and verify account index refcounts prior to clean"
accounts filler count

How many accounts to add to stress the system. Accounts are ignored in operations related to correctness.
accounts hash cache path

Use PATH as accounts hash cache location [default: <LEDGER>accounts_hash_cache]"
accounts filler size

Size per filler account in bytes.
accounts hash interval slots

Number of slots between verifying accounts hash.
accounts index bins

Number of bins to divide the accounts index into
accounts index flush threads

Number of threads to use for flushing the accounts index
accounts index memory limit mb

How much memory the accounts index can consume. If this is exceeded, some account index entries will be stored on disk."
accounts index path

Persistent accounts-index location. May be specified multiple times. [default: <LEDGER>accounts_index]"
accounts index scan results limit mb

How large accumulated results from an accounts index scan can become. If this is exceeded, the scan aborts."
accounts shrink optimize total space

When this is set to true, the system will shrink the most sparse accounts and when the overall shrink ratio is above the specified accounts-shrink-ratio, the shrink will stop and it will skip all other less sparse accounts."
accounts shrink ratio

Specifies the shrink ratio for the accounts to be shrunk. The shrink ratio is defined as the ratio of the bytes alive over the total bytes used. If the account's shrink ratio is less than this ratio it becomes a candidate for shrinking. The value must between 0. and 1.0 inclusive."
accountsdb repl bind address

IP address to bind the AccountsDb Replication port [default: use --bind-address]"
accountsdb repl port

Enable AccountsDb Replication Service on this port
accountsdb repl threads

Number of threads to use for servicing AccountsDb Replication requests
allow private addr

Allow contacting private ip addresses
authorized voter keypair

Path to keypair of the authorized voter to add [default: read JSON keypair from stdin]"
authorized voter keypairs

Include an additional authorized voter keypair. May be specified multiple times. [default: the --identity keypair]"
banking trace dir byte limit

Enables the banking trace explicitly, which is enabled by default and writes trace files for simulate-leader-blocks, retaining up to the default or specified total bytes in the ledger. This flag can be used to override its byte limit."
bind address

IP address to bind the validator ports
block production method

BlockProductionMethod::cli_message()
block verification method

BlockVerificationMethod::cli_message()
bpf program

Add a SBF program to the genesis configuration with upgrades disabled. If the ledger already exists then this parameter is silently ignored. The first argument can be a pubkey string or path to a keypair"
check vote account

Sanity check vote account state at startup. The JSON RPC endpoint at RPC_URL must expose `--full-rpc-api`"
clone account

Copy an account from the cluster referenced by the --url argument the genesis configuration. If the ledger already exists then this parameter is silently ignored"
clone feature set

Copy a feature set from the cluster referenced by the --url argument in the genesis configuration. If the ledger already exists then this parameter is silently ignored"
clone upgradeable program

Copy an upgradeable program and its executable data from the cluster referenced by the --url argument the genesis configuration. If the ledger already exists then this parameter is silently ignored"
compute unit limit

Override the runtime's compute unit limit per transaction
config

no description available
config file

Configuration file to use
contact debug interval

Milliseconds between printing contact debug from gossip.
cuda

Use CUDA
deactivate feature

deactivate this feature in genesis.
debug key

Log when transactions are processed which reference a given key.
delay leader block for pending fork

Delay leader block creation while replaying a block which descends from the current fork and has a lower slot than our next leader slot. If we don't delay here, our new leader block will be on a different fork from the block we are replaying and there is a high chance that the cluster will confirm that block's fork rather than our leader block's fork because it was created before we started creating ours."
dev halt at slot

Halt the validator when it reaches the given slot
disable accounts disk index

Disable the disk-based accounts index if it is enabled by default.
disable banking trace

Disables the banking trace
disable quic servers

Enable AccountsDb Replication
dynamic port range

Range to use for dynamically assigned ports
enable accountsdb repl

Enable AccountsDb Replication
enable bigtable ledger upload

Upload new confirmed blocks into a BigTable instance
enable cpi and log storage

Include CPI inner instructions, logs and return data in the historical transaction info stored"
enable quic servers

Only expose the RPC methods required to serve snapshots to other nodes
enable extended tx metadata storage

Include CPI inner instructions, logs, and return data in the historical transaction info stored"
enable rpc bigtable ledger storage

Fetch historical transaction info from a BigTable instance as a fallback to local ledger data"
enable rpc transaction history

Enable historical transaction info over JSON RPC, including the 'getConfirmedBlock' API. This will cause an increase in disk usage and IOPS"
entrypoint

Rendezvous with the cluster at this gossip entrypoint
etcd cacert file

verify the TLS certificate of the etcd endpoint using this CA bundle
etcd cert file

TLS certificate to use when establishing a connection to the etcd endpoint
etcd domain name

domain name against which to verify the etcd server’s TLS certificate
etcd endpoint

etcd gRPC endpoint to connect with
etcd key file

TLS key file to use when establishing a connection to the etcd endpoint
expected bank hash

When wait-for-supermajority <x>, require the bank at <x> to have this hash
expected shred version

Require the shred version be this value
expected genesis hash

Require the genesis have this hash
faucet per request sol cap

Per-request limit for faucet requests, in SOL
faucet per time sol cap

Per-time slice limit for faucet requests, in SOL
faucet port

Enable the faucet on this port
faucet sol

Give the faucet address this much SOL in genesis. If the ledger already exists then this parameter is silently ignored"
faucet time slice secs

Time slice (in secs) over which to limit faucet requests
filter

New filter using the same format as the RUST_LOG environment variable"
force

Request the validator exit immediately instead of waiting for a restart window"
full rpc api

Expose RPC methods for querying chain state and transaction history
full snapshot archive path

Use DIR as full snapshot archives location [default: --snapshots value]"
full snapshot interval slots

Number of slots between generating full snapshots
geyser plugin always enabled

Еnable Geyser interface even if no Geyser configs are specified.
geyser plugin config

Specify the configuration file for the Geyser plugin.
gossip host

Gossip DNS name or IP address for the validator to advertise in gossip [default: ask --entrypoint, or 127.0.0.1 when --entrypoint is not provided]"
gossip port

Gossip port number for the validator
gossip validators

A list of validators to gossip with. If specified, gossip will not pushpull from from validators outside this set. [default: all validators]"
halt on known validators accounts hash mismatch

Only expose the RPC methods required to serve snapshots to other nodes
hard forks

Add a hard fork at this slot
health check slot distance

Report this validator as healthy if its latest replayed optimistically confirmed slot is within the specified number of slots from the cluster's latest optimistically confirmed slot"
identity

Validator identity keypair
incremental snapshot archive path

Use DIR as incremental snapshot archives location [default: --snapshots value]"
incremental snapshot interval slots

Number of slots between generating snapshots, 0 to disable snapshots
incremental snapshots

Enable incremental snapshots
init complete file

Create this file if it doesn't already exist once validator initialization is complete"
ip echo server threads

Number of threads to use for the IP echo server
json rpc url

URL for Solana's JSON RPC or moniker (or their first letter): [mainnet-beta, testnet, devnet, localhost]"
known validators

A snapshot hash must be published in gossip by this validator to be accepted. May be specified multiple times. If unspecified any snapshot hash will be accepted"
ledger path

Use DIR as ledger location
limit ledger size

Keep this amount of shreds in root slots.
log

Log mode: stream the validator log
log messages bytes limit

Maximum number of bytes written to the program log before truncation
logfile

Redirect logging to the specified file, '-' for standard error. Sending the SIGUSR1 signal to the validator process will cause it to re-open the log file"
max delinquent stake

The maximum delinquent stake % permitted for an exit
max genesis archive unpacked size

maximum total uncompressed file size of downloaded genesis archive
maximum full snapshots to retain

The maximum number of full snapshot archives to hold on to when purging older snapshots."
maximum incremental snapshots to retain

The maximum number of incremental snapshot archives to hold on to when purging older snapshots."
maximum local snapshot age

Reuse a local snapshot if it's less than this many slots behind the highest snapshot available for download from other validators"
maximum snapshot download abort

The maximum number of times to abort and retry when encountering a slow snapshot download."
maybe clone account

Copy an account from the cluster referenced by the --url argument, skipping it if it doesn't exist. If the ledger already exists then this parameter is silently ignored"
minimal rpc api

Only expose the RPC methods required to serve snapshots to other nodes
min idle time

Minimum time that the validator should not be leader before restarting"
minimal snapshot download speed

The minimal speed of snapshot downloads measured in bytessecond. If the initial download speed falls below this threshold, the system will retry the download against a different rpc node."
mint address

Address of the mint account that will receive tokens created at genesis. If the ledger already exists then this parameter is silently ignored [default: client keypair]"
monitor

Monitor the validator after sending the exit request
name

no description available
no accounts db index hashing

This is obsolete. See --accounts-db-index-hashing. Disables the use of the index in hash calculation in AccountsHashVerifierAccounts Background Service."
no check vote account

Disable manual compaction of the ledger database
no genesis fetch

Do not fetch genesis from the cluster
no incremental snapshots

Disable incremental snapshots
no os cpu stats reporting

Disable reporting of OS CPU statistics.
no os disk stats reporting

Disable reporting of OS disk statistics.
no os memory stats reporting

Disable reporting of OS memory statistics.
no os network limits test

Skip checks for OS network limits.
no os network stats reporting

Disable reporting of OS network statistics.
no poh speed test

Skip the check for PoH speed.
no port check

Do not perform TCPUDP reachable port checks at start-up
no rocksdb compaction

Disable manual compaction of the ledger database
no skip initial accounts db clean

Do not skip the initial cleaning of accounts when verifying snapshot bank
no snapshot fetch

Do not attempt to fetch a snapshot from the cluster, start from a local snapshot if present"
no voting

Launch validator without voting
no wait for vote to start leader

If the validator starts up with no ledger, it will wait to start block production until it sees a vote land in a rooted slot. This prevents double signing. Turn off to risk double signing a block."
num quic endpoints

The number of QUIC endpoints used for TPU and TPU-Forward. It can be increased to increase network ingest throughput, at the expense of higher CPU and general validator load.
obsolete v1 7 rpc api

Enable the obsolete RPC methods removed in v1.7
only known rpc

Use the RPC service of known validators only
output

Output display mode
partitioned epoch rewards compare calculation

Do normal epoch rewards distribution, but also calculate rewards using the partitioned rewards code path and compare the resulting vote and stake accounts"
partitioned epoch rewards force enable single slot

Force the partitioned rewards distribution, but distribute all rewards in the first slot in the epoch. This should match consensus with the normal rewards distribution."
path

Provide path to a file with custom overrides for stakes of specific validator identities."
poh hashes per batch

Specify hashes per batch in PoH service
poh pinned cpu core

EXPERIMENTAL: Specify which CPU core PoH is pinned to
private rpc

Do not publish the RPC port for use by others
process ledger before services

Process the local ledger fully before starting networking services
pubkey

Identity pubkey of the validator to repair from
public rpc addr

RPC address for the validator to advertise publicly in gossip. Useful for validators running behind a load balancer or proxy [default: use --rpc-bind-address --rpc-port]"
public tpu addr

Specify TPU address to advertise in gossip [default: ask --entrypoint or localhost when --entrypoint is not provided]"
public tpu forwards addr

Specify TPU Forwards address to advertise in gossip [default: ask --entrypoint or localhostwhen --entrypoint is not provided]"
quiet

Quiet mode: suppress normal output
rayon global threads

Number of threads to use for the global rayon thread pool
repair whitelist

A list of validators to prioritize repairs from. If specified, repair requests from validators in the list will be prioritized over requests from other validators. [default: all validators]"
repair validators

A list of validators to request repairs from. If specified, repair will not request from validators outside this set [default: all validators]"
replay forks threads

Number of threads to use for replay of blocks on different forks
replay slots concurrently

The maximum size in bytes to which the outgoing websocket buffer can grow.
replay transactions threads

Number of threads to use for transaction replay
require tower

Refuse to start if saved tower state is not found
reset

Reset the ledger to genesis if it exists. By default the validator will resume an existing ledger (if present)"
restricted repair only mode

Do not publish the Gossip, TPU, TVU or Repair Service ports. Doing so causes the node to operate in a limited capacity that reduces its exposure to the rest of the cluster. The --no-voting flag is implicit when this flag is enabled"
rocksdb compaction interval

Number of slots between compacting ledger
rocksdb compaction threads

Number of threads to use for rocksdb (Blockstore) compactions
rocksdb fifo shred storage size

The shred storage size in bytes. The suggested value is at least 50% of your ledger storage size. If this argument is unspecified, we will assign a proper value based on --limit-ledger-size. If --limit-ledger-size is not presented, it means there is no limitation on the ledger size and thus rocksdb_fifo_shred_storage_size will also be unbounded."
rocksdb flush threads

Number of threads to use for rocksdb (Blockstore) memtable flushes
rocksdb ledger compression

The compression algorithm that is used to compress transaction status data. Turning on compression can save ~10% of the ledger size."
rocksdb max compaction jitter

Introduce jitter into the compaction to offset compaction operation
rocksdb perf sample interval

Controls how often RocksDB readwrite performance samples are collected. Perf samples are collected in 1 ROCKS_PERF_SAMPLE_INTERVAL sampling rate."
rocksdb shred compaction

Controls how RocksDB compacts shreds. *WARNING*: You will lose your Blockstore data when you switch between options. Possible values are: 'level': stores shreds using RocksDB's default (level) compaction."
rpc bigtable app profile id

Bigtable application profile id to use in requests
rpc bigtable instance

Name of BigTable instance to target
rpc bigtable instance name

Name of the Bigtable instance to upload to
rpc bigtable timeout

Number of seconds before timing out RPC requests backed by BigTable
rpc bigtable max message size

Max encoding and decoding message size used in Bigtable Grpc client
rpc bind address

IP address to bind the RPC port [default: 127.0.0.1 if --private-rpc is present, otherwise use --bind-address]"
rpc blocking threads

Number of blocking threads to use for servicing CPU bound RPC requests (eg getMultipleAccounts)
rpc faucet addr

Enable the JSON RPC 'requestAirdrop' API with this faucet address.
rpc max multiple accounts

Override the default maximum accounts accepted by the getMultipleAccounts JSON RPC method"
rpc max request body size

The maximum request body size accepted by rpc service
rpc niceness adj

Add this value to niceness of RPC threads. Negative value increases priority, positive value decreases priority."
rpc port

Enable JSON RPC on this port, and the next port for the RPC websocket
rpc pubsub enable block subscription

Enable the unstable RPC PubSub `blockSubscribe` subscription
rpc pubsub max active subscriptions

The maximum number of active subscriptions that RPC PubSub will accept across all connections."
rpc pubsub enable vote subscription

Enable the unstable RPC PubSub `voteSubscribe` subscription
rpc pubsub max connections

The maximum number of connections that RPC PubSub will support. This is a hard limit and no new connections beyond this limit can be made until an old connection is dropped.
rpc pubsub max fragment size

The maximum length in bytes of acceptable incoming frames. Messages longer than this will be rejected
rpc pubsub max in buffer capacity

The maximum size in bytes to which the incoming websocket buffer can grow.
rpc pubsub max out buffer capacity

The maximum size in bytes to which the outgoing websocket buffer can grow.
rpc pubsub notification threads

The maximum number of threads that RPC PubSub will use for generating notifications. 0 will disable RPC PubSub notifications"
rpc pubsub queue capacity bytes

The maximum total size of notifications that RPC PubSub will store across all connections."
rpc pubsub queue capacity items

The maximum number of notifications that RPC PubSub will store across all connections."
rpc pubsub worker threads

PubSub worker threads
rpc scan and fix roots

Verifies blockstore roots on boot and fixes any gaps
rpc send transaction also leader

With `--rpc-send-transaction-tpu-peer HOST:PORT`, also send to the current leader
rpc send transaction batch size

The size of transactions to be sent in batch.
rpc send transaction batch ms

The rate at which transactions sent via rpc service are sent in batch.
rpc send transaction default max retries

The maximum number of transaction broadcast retries when unspecified by the request, otherwise retried until expiration."
rpc send transaction leader forward count

The number of upcoming leaders to which to forward transactions sent via rpc service."
rpc send transaction retry ms

The rate at which transactions sent via rpc service are retried.
rpc send transaction retry pool max size

The maximum size of transactions retry pool.
rpc send transaction service max retries

The maximum number of transaction broadcast retries, regardless of requested value."
rpc send transaction tpu peer

Peer(s) to broadcast transactions to instead of the current leader
rpc threads

Number of threads to use for servicing RPC requests
shred

Shred to repair
skip health check

Skip health check
skip new snapshot check

Skip check for a new snapshot
skip poh verify

Skip ledger verification at validator bootup.
skip preflight health check

Skip health check when running a preflight check"
skip startup ledger verification

Skip ledger verification at validator bootup.
slots per epoch

Override the number of slots in an epoch. If the ledger already exists then this parameter is silently ignored"
slot

Slot to repair
snapshot archive format

Snapshot archive format to use.
snapshot interval slots

Number of slots between generating snapshots
snapshot packager niceness adj

Add this value to niceness of snapshot packager thread. Negative value increases priority, positive value decreases priority."
snapshot version

Output snapshot version
snapshot zstd compression level

The compression level to use when archiving with zstd
snapshots

Use DIR as the base location for snapshots. A subdirectory named "snapshots" will be created. [default: --ledger value]"
staked nodes overrides

Provide path to a yaml file with custom overrides for stakes of specific identities. Overriding the amount of stake this validator considers as valid for other peers in network. The stake amount is used for calculating the number of QUIC streams permitted from the peer and vote packet sender stage. Format of the file: `staked_map_id: {<pubkey>: <SOL stake amount>}"
tower

Use DIR as file tower storage location [default: --ledger value]
tower storage

Where to store the tower
ticks per slot

The number of ticks in a slot
tpu addr

TPU address to advertise in gossip
tpu coalesce ms

Milliseconds to wait in the TPU receiver for packet coalescing.
tpu connection pool size

Controls the TPU connection pool size per remote address
tpu disable quic

Do not use QUIC to send transactions.
tpu enable udp

Enable UDP for receivingsending transactions.
tpu forwards addr

TPU Forwards address to advertise in gossip
tpu max connections per ipaddr per minute

Controls the rate of the clients connections per IpAddr per minute.
tpu max connections per peer

Controls the max concurrent connections per IpAddr.
tpu max fwd staked connections

Controls the max concurrent connections for TPU-forward from staked nodes.
tpu max fwd unstaked connections

Controls the max concurrent connections for TPU-forward from unstaked nodes.
tpu max staked connections

Controls the max concurrent connections for TPU from staked nodes.
tpu max streams per ms

Controls the max number of streams for a TPU service.
tpu max unstaked connections

Controls the max concurrent connections fort TPU from unstaked nodes.
tpu use quic

Use QUIC to send transactions.
transaction account lock limit

Override the runtime's account lock limit per transaction
transaction struct

TransactionStructure::cli_message()
tvu receive threads

no description available
tvu shred sigverify threads

no description available
unified scheduler handler threads

DefaultSchedulerPool::cli_message()
upgradeable program

Add an upgradeable SBF program to the genesis configuration. If the ledger already exists then this parameter is silently ignored. First and third arguments can be a pubkey string or path to a keypair. Upgrade authority set to "none" disables upgrades"
vote account

Validator vote account public key. If unspecified, voting will be disabled. The authorized voter for the account must either be the --identity keypair or set by the --authorized-voter argument"
vote use quic

Controls if to use QUIC to send votes.
wait for supermajority

After processing the ledger and the next slot is SLOT, wait until a supermajority of stake is visible on gossip before starting PoH"
wal recovery mode

Mode to recovery the ledger db write ahead log.
warp slot

Warp the ledger to WARP_SLOT after starting the validator. If no slot is provided then the current slot of the cluster referenced by the --url argument will be used"
wen restart

Only used during coordinated cluster restarts. nn Need to also specify the leader's pubkey in --wen-restart-leader. nn When specified, the validator will enter Wen Restart mode which pauses normal activity. Validators in this mode will gossip their last vote to reach consensus on a safe restart slot and repair all blocks on the selected fork. The safe slot will be a descendant of the latest optimistically confirmed slot to ensure we do not roll back any optimistically confirmed slots. nn The progress in this mode will be saved in the file location provided. If consensus is reached, the validator will automatically exit with 200 status code. Then the operators are expected to restart the validator with --wait_for_supermajority and other arguments (including new shred_version, supermajority slot, and bankhash) given in the error log before the exit so the cluster will resume execution. The progress file will be kept around for future debugging. nn If wen_restart fails, refer to the progress file (in proto3 format) for further debugging and watch the discord channel for instructions."
wen restart coordinator

Specifies the pubkey of the leader used in wen restart. May get stuck if the leader used is different from others."
whitelist

Set the validator's repair protocol whitelist

on x /
github /
web /
[email protected]

solana

cli

press esc or click anywhere to close