2014-06-10 11:43:27 +02:00
|
|
|
##
|
|
|
|
## bitcoin.conf configuration file. Lines beginning with # are comments.
|
|
|
|
##
|
2019-09-08 05:52:45 +02:00
|
|
|
|
2011-10-25 22:48:36 +02:00
|
|
|
# Network-related settings:
|
|
|
|
|
2019-02-12 07:25:36 +01:00
|
|
|
# Note that if you use testnet or regtest, particularly with the options
|
|
|
|
# addnode, connect, port, bind, rpcport, rpcbind or wallet, you will also
|
|
|
|
# want to read "[Sections]" further down.
|
|
|
|
|
2011-10-25 22:48:36 +02:00
|
|
|
# Run on the test network instead of the real bitcoin network.
|
2014-06-10 11:43:27 +02:00
|
|
|
#testnet=0
|
|
|
|
|
|
|
|
# Run a regression test network
|
|
|
|
#regtest=0
|
2011-10-25 22:48:36 +02:00
|
|
|
|
2014-07-24 15:55:49 +02:00
|
|
|
# Connect via a SOCKS5 proxy
|
2011-10-25 22:48:36 +02:00
|
|
|
#proxy=127.0.0.1:9050
|
|
|
|
|
2015-03-22 03:05:17 +01:00
|
|
|
# Bind to given address and always listen on it. Use [host]:port notation for IPv6
|
|
|
|
#bind=<addr>
|
|
|
|
|
|
|
|
# Bind to given address and whitelist peers connecting to it. Use [host]:port notation for IPv6
|
|
|
|
#whitebind=<addr>
|
|
|
|
|
2014-06-10 11:43:27 +02:00
|
|
|
##############################################################
|
|
|
|
## Quick Primer on addnode vs connect ##
|
|
|
|
## Let's say for instance you use addnode=4.2.2.4 ##
|
|
|
|
## addnode will connect you to and tell you about the ##
|
|
|
|
## nodes connected to 4.2.2.4. In addition it will tell ##
|
|
|
|
## the other nodes connected to it that you exist so ##
|
|
|
|
## they can connect to you. ##
|
|
|
|
## connect will not do the above when you 'connect' to it. ##
|
|
|
|
## It will *only* connect you to 4.2.2.4 and no one else.##
|
|
|
|
## ##
|
|
|
|
## So if you're behind a firewall, or have other problems ##
|
|
|
|
## finding nodes, add some using 'addnode'. ##
|
|
|
|
## ##
|
|
|
|
## If you want to stay private, use 'connect' to only ##
|
|
|
|
## connect to "trusted" nodes. ##
|
|
|
|
## ##
|
|
|
|
## If you run multiple nodes on a LAN, there's no need for ##
|
|
|
|
## all of them to open lots of connections. Instead ##
|
|
|
|
## 'connect' them all to one node that is port forwarded ##
|
|
|
|
## and has lots of connections. ##
|
|
|
|
## Thanks goes to [Noodle] on Freenode. ##
|
|
|
|
##############################################################
|
|
|
|
|
2011-10-25 22:48:36 +02:00
|
|
|
# Use as many addnode= settings as you like to connect to specific peers
|
|
|
|
#addnode=69.164.218.197
|
|
|
|
#addnode=10.0.0.2:8333
|
|
|
|
|
2014-06-10 11:43:27 +02:00
|
|
|
# Alternatively use as many connect= settings as you like to connect ONLY to specific peers
|
2011-10-25 22:48:36 +02:00
|
|
|
#connect=69.164.218.197
|
|
|
|
#connect=10.0.0.1:8333
|
|
|
|
|
2014-06-10 11:43:27 +02:00
|
|
|
# Listening mode, enabled by default except when 'connect' is being used
|
|
|
|
#listen=1
|
|
|
|
|
2019-02-12 07:25:36 +01:00
|
|
|
# Port on which to listen for connections (default: 8333, testnet: 18333, regtest: 18444)
|
|
|
|
#port=
|
|
|
|
|
2011-10-25 22:48:36 +02:00
|
|
|
# Maximum number of inbound+outbound connections.
|
|
|
|
#maxconnections=
|
|
|
|
|
2014-06-10 11:43:27 +02:00
|
|
|
#
|
2011-10-25 22:48:36 +02:00
|
|
|
# JSON-RPC options (for controlling a running Bitcoin/bitcoind process)
|
2014-06-10 11:43:27 +02:00
|
|
|
#
|
2011-10-25 22:48:36 +02:00
|
|
|
|
2015-09-22 09:25:26 +02:00
|
|
|
# server=1 tells Bitcoin-Qt and bitcoind to accept JSON-RPC commands
|
2014-06-10 11:43:27 +02:00
|
|
|
#server=0
|
2011-10-25 22:48:36 +02:00
|
|
|
|
2019-08-16 16:53:44 +02:00
|
|
|
# Bind to given address to listen for JSON-RPC connections.
|
|
|
|
# Refer to the manpage or bitcoind -help for further details.
|
2015-03-22 03:05:17 +01:00
|
|
|
#rpcbind=<addr>
|
|
|
|
|
2016-12-21 14:45:59 +01:00
|
|
|
# If no rpcpassword is set, rpc cookie auth is sought. The default `-rpccookiefile` name
|
|
|
|
# is .cookie and found in the `-datadir` being used for bitcoind. This option is typically used
|
|
|
|
# when the server and client are run as the same user.
|
|
|
|
#
|
2016-06-29 13:13:00 +02:00
|
|
|
# If not, you must set rpcuser and rpcpassword to secure the JSON-RPC API.
|
2016-12-21 14:45:59 +01:00
|
|
|
#
|
2016-06-29 13:13:00 +02:00
|
|
|
# The config option `rpcauth` can be added to server startup argument. It is set at initialization time
|
2018-05-01 17:03:49 +02:00
|
|
|
# using the output from the script in share/rpcauth/rpcauth.py after providing a username:
|
2016-12-21 14:45:59 +01:00
|
|
|
#
|
2018-05-01 17:03:49 +02:00
|
|
|
# ./share/rpcauth/rpcauth.py alice
|
2016-12-21 14:45:59 +01:00
|
|
|
# String to be appended to bitcoin.conf:
|
|
|
|
# rpcauth=alice:f7efda5c189b999524f151318c0c86$d5b51b3beffbc02b724e5d095828e0bc8b2456e9ac8757ae3211a5d9b16a22ae
|
|
|
|
# Your password:
|
|
|
|
# DONT_USE_THIS_YOU_WILL_GET_ROBBED_8ak1gI25KFTvjovL3gAM967mies3E=
|
|
|
|
#
|
|
|
|
# On client-side, you add the normal user/password pair to send commands:
|
|
|
|
#rpcuser=alice
|
|
|
|
#rpcpassword=DONT_USE_THIS_YOU_WILL_GET_ROBBED_8ak1gI25KFTvjovL3gAM967mies3E=
|
|
|
|
#
|
|
|
|
# You can even add multiple entries of these to the server conf file, and client can use any of them:
|
|
|
|
# rpcauth=bob:b2dd077cb54591a2f3139e69a897ac$4e71f08d48b4347cf8eff3815c0e25ae2e9a4340474079f55705f40574f4ec99
|
2014-06-10 11:43:27 +02:00
|
|
|
|
|
|
|
# How many seconds bitcoin will wait for a complete RPC HTTP request.
|
2019-09-08 05:52:45 +02:00
|
|
|
# after the HTTP connection is established.
|
2015-09-18 15:45:38 +02:00
|
|
|
#rpcclienttimeout=30
|
2011-10-25 22:48:36 +02:00
|
|
|
|
2014-06-10 11:43:27 +02:00
|
|
|
# By default, only RPC connections from localhost are allowed.
|
|
|
|
# Specify as many rpcallowip= settings as you like to allow connections from other hosts,
|
|
|
|
# either as a single IPv4/IPv6 or with a subnet specification.
|
|
|
|
|
|
|
|
# NOTE: opening up the RPC port to hosts outside your local trusted network is NOT RECOMMENDED,
|
|
|
|
# because the rpcpassword is transmitted over the network unencrypted.
|
|
|
|
|
2015-09-22 09:25:26 +02:00
|
|
|
# server=1 tells Bitcoin-Qt to accept JSON-RPC commands.
|
2019-09-08 05:52:45 +02:00
|
|
|
# it is also read by bitcoind to determine if RPC should be enabled
|
2014-06-10 11:43:27 +02:00
|
|
|
#rpcallowip=10.1.1.34/255.255.255.0
|
|
|
|
#rpcallowip=1.2.3.4/24
|
|
|
|
#rpcallowip=2001:db8:85a3:0:0:8a2e:370:7334/96
|
2011-10-25 22:48:36 +02:00
|
|
|
|
|
|
|
# Listen for RPC connections on this TCP port:
|
2014-06-10 11:43:27 +02:00
|
|
|
#rpcport=8332
|
2011-10-25 22:48:36 +02:00
|
|
|
|
|
|
|
# You can use Bitcoin or bitcoind to send commands to Bitcoin/bitcoind
|
|
|
|
# running on another host using this option:
|
2014-06-10 11:43:27 +02:00
|
|
|
#rpcconnect=127.0.0.1
|
2011-10-25 22:48:36 +02:00
|
|
|
|
2016-06-29 13:13:00 +02:00
|
|
|
# Wallet options
|
|
|
|
|
2019-02-12 07:25:36 +01:00
|
|
|
# Specify where to find wallet, lockfile and logs. If not present, those files will be
|
|
|
|
# created as new.
|
|
|
|
#wallet=</path/to/dir>
|
|
|
|
|
2017-03-03 16:40:42 +01:00
|
|
|
# Create transactions that have enough fees so they are likely to begin confirmation within n blocks (default: 6).
|
2015-03-22 03:05:17 +01:00
|
|
|
# This setting is over-ridden by the -paytxfee option.
|
|
|
|
#txconfirmtarget=n
|
2011-10-25 22:48:36 +02:00
|
|
|
|
2016-06-29 13:13:00 +02:00
|
|
|
# Pay a transaction fee every time you send bitcoins.
|
|
|
|
#paytxfee=0.000x
|
|
|
|
|
2011-10-25 22:48:36 +02:00
|
|
|
# Miscellaneous options
|
|
|
|
|
|
|
|
# Pre-generate this many public/private key pairs, so wallet backups will be valid for
|
|
|
|
# both prior transactions and several dozen future transactions.
|
2014-06-10 11:43:27 +02:00
|
|
|
#keypool=100
|
2011-10-25 22:48:36 +02:00
|
|
|
|
2019-09-08 05:52:45 +02:00
|
|
|
# Enable pruning to reduce storage requirements by deleting old blocks.
|
2017-03-26 22:27:53 +02:00
|
|
|
# This mode is incompatible with -txindex and -rescan.
|
|
|
|
# 0 = default (no pruning).
|
|
|
|
# 1 = allows manual pruning via RPC.
|
2019-09-08 05:52:45 +02:00
|
|
|
# >=550 = target to stay under in MiB.
|
2017-03-26 22:27:53 +02:00
|
|
|
#prune=550
|
|
|
|
|
2011-10-25 22:48:36 +02:00
|
|
|
# User interface options
|
|
|
|
|
|
|
|
# Start Bitcoin minimized
|
|
|
|
#min=1
|
|
|
|
|
|
|
|
# Minimize to the system tray
|
|
|
|
#minimizetotray=1
|
2019-02-12 07:25:36 +01:00
|
|
|
|
|
|
|
# [Sections]
|
|
|
|
# Most options apply to mainnet, testnet and regtest.
|
|
|
|
# If you want to confine an option to just one network, you should add it in the
|
|
|
|
# relevant section below.
|
|
|
|
# EXCEPTIONS: The options addnode, connect, port, bind, rpcport, rpcbind and wallet
|
|
|
|
# only apply to mainnet unless they appear in the appropriate section below.
|
|
|
|
|
|
|
|
# Options only for mainnet
|
|
|
|
[main]
|
|
|
|
|
|
|
|
# Options only for testnet
|
|
|
|
[test]
|
|
|
|
|
|
|
|
# Options only for regtest
|
|
|
|
[regtest]
|