BITCOIND(1) User Commands BITCOIND(1) (NAME) bitcoind - (Bitcoin Core) (SYNOPSIS) bitcoind [options] (DESCRIPTION) v31.1.0 bitcoind (bitcoind) (headless) . RPC REST ZMQ . . . (OPTIONS) -alertnotify= (%s ) -allowignoredconf bitcoin.conf datadir . -assumevalid= (0 : 00000000000000000000ccebd6d74d9194d8dcdc1d177c478e094bfad51ba5ac testnet3: 000000007a61e4230b28ac5cb6b5e5a0130de37ac1faf2f8987d2fa6505b67f4 testnet4: 0000000002368b1e4ee27e2e85676ae6f9f9e69579b29093e9a82c170bf7cf8a signet: 00000008414aab61092ef93f1aacc54cf9e9f16af29ddad493b908a01ff5c329) -blockfilterindex= (index) (: 0 : basic). 1 . -blocknotify= (%s ) -blockreconstructionextratxn= (: 100) -blocksdir= *.dat (: ) -blocksonly . 'forcerelay' . RPC . (: 0) -blocksxor XOR *.dat blocksdir. blocksdir `-blocksxor=0` blocksdir . (: 1) -coinstatsindex RPC gettxoutsetinfo (: 0) -conf= . datadir ( ) (: bitcoin.conf) -daemon (: 0) -daemonwait . -daemon (: 0) -datadir= -dbcache= () ( 4 : 1024). . mempool ( -maxmempool ). -debuglogfile= (: debug.log). datadir . -nodebuglogfile . -help ( -h -?) -includeconf= -datadir ( ) -loadblock= -maxmempool= (: 300) -mempoolexpiry= mempool (: 336) -par= (0 = 15 0 = : 0) -persistmempool mempool (: 1) -persistmempoolv1 mempool.dat -persistmempool RPC savemempool ( 1) ( 2). . (: 0) -pid= pid. datadir . (: bitcoind.pid) -prune= () . RPC pruneblockchain . -txindex . : . (: 0 = 1 = RPC >=550 = ) -reindex blk*.dat . . assumeutxo chainstate . RPC . -reindex-chainstate blk*.dat . assumeutxo chainstate . -settings= . -nosettings . ( bitcoin.conf ). datadir . (: settings.json) -shutdownnotify= . ( ). -startupnotify= . -txindex rpc getrawtransaction (: 0) -txospenderindex rpc gettxspendingprevout (: 0) -version : -addnode= ( RPC addnode ). -maxconnections . -asmap= asn . datadir . (-asmap -asmap=1) . -bantime= ( ) (: 86400) -bind=[:][=onion] (: 0.0.0.0). IPv6 [host]:port . =onion (Tor) (: 127.0.0.1:8334=onion testnet3: 127.0.0.1:18334=onion testnet4: 127.0.0.1:48334=onion signet: 127.0.0.1:38334=onion regtest: 127.0.0.1:18445=onion) -cjdnsreachable CJDNS ( fc00::/8 CJDNS doc/cjdns.md ) (: 0) -connect= -noconnect ( -addnode ). . -discover IP (: 1 -externalip -proxy) -dns DNS -addnode -seednode -connect (: 1) -dnsseed DNS lookup (: 1 -connect -maxconnections=0) -externalip= -fixedseeds (fixed seeds) DNS (: 1) -forcednsseed DNS (: 0) -i2pacceptincoming I2P (: 1). -i2psam . I2P SAM . -i2psam= I2P SAM I2P I2P -listen (: 1 -proxy -connect -maxconnections=0) -listenonion (Tor onion service) (: 1) -maxconnections= (: 125). -addnode RPC ( ). ( ). -maxreceivebuffer= *1000 (: 5000) -maxsendbuffer= *1000 (: 1000) -maxuploadtarget= . 'download' . 0 = (: 0M). [k|K|m|M|g|G|t|T] (: M). 1000 1024 . -natpmp PCP NAT-PMP (: 1) -networkactive P2P (: 1). RPC setnetworkactive . -onion= SOCKS5 Tor -noonion (: -proxy). 'unix:' . -onlynet= (ipv4 ipv6 onion i2p cjdns). . . -peerblockfilters BIP 157 (: 0) -peerbloomfilters (: 0) -port= (: 8333 testnet3: 18333 testnet4: 48333 signet: 38333 regtest: 18444). I2P (doc/i2p.md ). x x+1 . -proxy=[:]|unix:[=] SOCKS5 -noproxy . 'unix:' . =network . ipv4 ipv6 tor cjdns . (: ) -proxyrandomize . Tor (: 1) -seednode= . . dnsseeds . -timeout= . (: 1 : 5000) -torcontrol=: Tor (: 127.0.0.1:9051). 9051 . -torpassword= Tor (: ) -v2transport (v2 transport) (: 1) -whitebind=<[permissions@]addr> . IPv6 [host]:port . : bloomfilter ( BIP37) noban ( download) forcerelay ( mempool relay) relay ( -blocksonly ) mempool ( mempool BIP35) download ( getheaders IBD maxuploadtarget) addr ( GETADDR ). (: download,noban,mempool,relay). . -whitelist=<[permissions@]IP address or network> IP ( 1.2.3.4) CIDR ( 1.2.3.0/24) . -whitebind . "in" "out" (: ). . (Wallet): -addresstype ("legacy" "p2sh-segwit" "bech32" "bech32m" : "bech32") -avoidpartialspends ( ) . . . "avoid_reuse" : 0. -changetype (change) ("legacy" "p2sh-segwit" "bech32" "bech32m"). -addresstype=legacy "legacy" . -consolidatefeerate= ( BTC/kvB) UTXO (: 0.0001). -disablewallet RPC -discardfee= ( BTC/kvB) (: 0.0001). -fallbackfee= ( BTC/kvB) . 0 fallbackfee . (: 0.00) -keypool= (: 1000). : . -maxapsfee= ( BTC) (: 0.00) -mintxfee= ( BTC/kvB) (: 0.00001) -signer= doc/external-signer.md -spendzeroconfchange (: 1) -txconfirmtarget= n (: 6) -wallet= . . . . . -walletbroadcast (: 1) -walletdir= (: /wallets ) -walletnotify= . %s TxID %w %b ( 'unconfirmed') %h (-1 ) . -walletrbf (full-RBF opt-in) ( RPC : 1) ZeroMQ: -zmqpubhashblock=
-zmqpubhashblockhwm= (high water mark) (: 1000) -zmqpubhashtx=
-zmqpubhashtxhwm= (: 1000) -zmqpubrawblock=
-zmqpubrawblockhwm= (: 1000) -zmqpubrawtx=
-zmqpubrawtxhwm= (: 1000) -zmqpubsequence=
-zmqpubsequencehwm= (: 1000) (Debugging/Testing): -debug= (: -nodebug ). 1 "all" . 0 "none" . : addrman bench blockstorage cmpctblock coindb estimatefee http i2p ipc kernel leveldb libevent mempool mempoolrej net privatebroadcast proxy prune qt rand reindex rpc scan selectcoins tor txpackages txreconciliation validation walletdb zmq. . -debugexclude= . -debug=1 . "-debug" . -help-debug -logips IP (: 0) -loglevelalways (: 0) -logsourcelocations ( ) (: 0) -logthreadnames (: 0) -logtimestamps (: 1) -maxtxfee= ( BTC) (: 0.10) -printtoconsole (: 1 -daemon. -nodebuglogfile ) -shrinkdebugfile debug.log (: 1 -debug) -uacomment= User Agent (Chain selection): -chain= (: main). : main test testnet4 signet regtest -signet signet. -chain=signet. -signetchallenge . -signetchallenge ( signet) -signetseednode signet hostname[:port] sig.net:1234 -testnet testnet3. -chain=test. testnet3 . -testnet4 testnet4 . -testnet4 testnet4. -chain=testnet4. (Node relay): -bytespersigop sigop (: 20) -datacarrier (: 1) -datacarriersize scriptPubKey (: 100000) -minrelaytxfee= ( BTC/kvB) (: 0.000001) -permitbaremultisig P2SH (: 1) -privatebroadcast RPC sendrawtransaction Tor I2P mempool (: 0) -whitelistforcerelay 'forcerelay' (: 0) -whitelistrelay 'relay' (: 1) (Block creation): -blockmintxfee= ( BTC/kvB) (: 0.00000001) -blockreservedweight= coinbase (: 8000). RPC: -rest REST (: 0) -rpcallowip= JSON-RPC . IP / CIDR ipv4 (0.0.0.0/0) ipv6 (::/0). -rpcauth= HMAC-SHA-256 JSON-RPC :$. . -rpcbind=[:port] JSON-RPC. RPC ! -rpcallowip . -rpcport . IPv6 [host]:port . (: 127.0.0.1 ::1 localhost) -rpccookiefile= . datadir . (: ) -rpccookieperms= RPC [owner|group|all] (: owner [ umask 0077]) -rpcpassword= JSON-RPC -rpcport= JSON-RPC (: 8332 testnet3: 18332 testnet4: 48332 signet: 38332 regtest: 18443) -rpcthreads= RPC (: 16) -rpcuser= JSON-RPC -rpcwhitelist= RPC : :,,...,. -rpcwhitelistdefault rpc. -server JSON-RPC (COPYRIGHT) (C) 2009-2026 Bitcoin Core . . . . MIT COPYING . (SEE ALSO) bitcoin(1), bitcoind(1), bitcoin-cli(1), bitcoin-tx(1), bitcoin- wallet(1), bitcoin-util(1), bitcoin-qt(1) bitcoind v31.1.0 July 2026 BITCOIND(1)