Command Line Options

  bitcoind [options]
  bitcoind [options] (command) [params]  Send command to -server or bitcoind
  bitcoind [options] help                List commands
  bitcoind [options] help (command)      Get help for a command

Note: Many of these options can also be stored in a bitcoin.conf configuration file.

Standard Options:

List usage and command-line options
Specify configuration file (default: bitcoin.conf)
Specify process identifier file (default:
Generate coins (obsolete)
Specify data directory
Set database cache size in megabytes (default: 25)
Specify connection timeout in milliseconds (default: 5000)
Connect through socks proxy
Select the version of socks proxy to use (4-5, default: 5)
Use proxy to reach tor hidden services (default: same as -proxy)
Allow DNS lookups for -addnode, -seednode and -connect
Listen for connections on (default: 8333 or testnet: 18333)
Maintain at most (n) connections to peers (default: 125)
Add a node to connect to and attempt to keep the connection open
Connect only to the specified node(s)
Connect to a node to retrieve peer addresses, and disconnect
Specify your own public address
Only connect to nodes in network (net) (IPv4, IPv6 or Tor)
Discover own IP address (default: 1 when listening and no -externalip)
Find peers using internet relay chat (default: 0) (removed in latest versions)
Only accept block chain matching built-in checkpoints (default: 1)
Accept connections from outside (default: 1 if no -proxy or -connect)
Bind to given address and always listen on it. Use [host]:port notation for IPv6
Find peers using DNS lookup (default: 1 unless -connect)
Threshold for disconnecting misbehaving peers (default: 100)
Number of seconds to keep misbehaving peers from reconnecting (default: 86400)
Maximum per-connection receive buffer, (n)*1000 bytes (default: 5000)
Maximum per-connection send buffer, (n)*1000 bytes (default: 1000)
Use UPnP to map the listening port (default: 0)
Fee per KB to add to transactions you send
Accept command line and JSON-RPC commands
Use the test network
Output extra debugging information. Implies all other -debug* options
Output extra network debugging information
Prepend debug output with timestamp
Shrink debug.log file on client startup (default: 1 when no -debug)
Send trace/debug info to console instead of debug.log file
Send trace/debug info to debugger
Username for JSON-RPC connections
Password for JSON-RPC connections
Listen for JSON-RPC connections on (port) (default: 8332 or testnet: 18332)
Allow JSON-RPC connections from specified IP address
Set the number of threads to service RPC calls (default: 4)
Send commands to node running on (IP) (default: (removed)
Execute command when the best block changes (%s in (cmd) is replaced by block hash)
Execute command when a wallet transaction changes (%s in cmd is replaced by TxID)
Execute command when a relevant alert is received (%s in cmd is replaced by message)
Upgrade wallet to latest format
Set key pool size to (n) (default: 100)
Rescan the block chain for missing wallet transactions
Attempt to recover private keys from a corrupt wallet.dat
How many blocks to check at startup (default: 288, 0 = all)
How thorough the block verification is (0-4, default: 3)
Maintain a full transaction index (default: 0)
Imports blocks from external blk000??.dat formatted files
Rebuild blockchain index from current blk000??.dat files
Set the number of script verification threads (1-16, 0=auto, default: 0)

Block creation options:

Set minimum block size in bytes (default: 0)
Set maximum block size in bytes (default: 250000)
Set maximum size of high-priority/low-fee transactions in bytes (default: 27000)

SSL options:

(See the Bitcoin Wiki for SSL setup instructions)

Use OpenSSL (https) for JSON-RPC connections
-rpcsslcertificatechainfile=(file .cert)
Server certificate file (default: server.cert)
-rpcsslprivatekeyfile=(file .pem)
Server private key (default: server.pem)
Acceptable ciphers (default: TLSv1+HIGH:!SSLv2:!aNULL:!eNULL:!AH:!3DES:@STRENGTH)

User interface options:

Set language, for example “de_DE” (default: system locale)
Start minimized
Disable splash screen on startup (default: 1)