94 lines
4.2 KiB
94 lines
4.2 KiB
.TH BITCOIN.CONF "5" "January 2011" "bitcoin.conf 3.19" |
|
.SH NAME |
|
bitcoin.conf \- bitcoin configuration file |
|
.SH SYNOPSIS |
|
All command-line options (except for '-datadir' and '-conf') may be specified in a configuration file, and all configuration file options may also be specified on the command line. Command-line options override values set in the configuration file. |
|
.TP |
|
The configuration file is a list of 'setting=value' pairs, one per line, with optional comments starting with the '#' character. |
|
.TP |
|
The configuration file is not automatically created; you can create it using your favorite plain-text editor. By default, bitcoind(1) will look for a file named bitcoin.conf(5) in the bitcoin data directory, but both the data directory and the configuration file path may be changed using the '-datadir' and '-conf' command-line arguments. |
|
.SH LOCATION |
|
bitcoin.conf should be located in $HOME/.bitcoin |
|
.SH NETWORK-RELATED SETTINGS |
|
.TP |
|
.TP |
|
\fBtestnet=\fR[\fI'1'\fR|\fI'0'\fR] |
|
Enable or disable run on the test network instead of the real *bitcoin* network. |
|
.TP |
|
\fBproxy=\fR\fI'127.0.0.1:9050'\fR |
|
Connect via a socks4 proxy. |
|
.TP |
|
\fBaddnode=\fR\fI'10.0.0.2:8333'\fR |
|
Use as many *addnode=* settings as you like to connect to specific peers. |
|
.TP |
|
\fBconnect=\fR\fI'10.0.0.1:8333'\fR |
|
Use as many *connect=* settings as you like to connect ONLY to specific peers. |
|
.TP |
|
\fBnoirc=\fR[\fI'1'\fR|\fI'0'\fR] |
|
Use or Do not use Internet Relay Chat (irc.lfnet.org #bitcoin channel) to find other peers. |
|
.TP |
|
\fRmaxconnections=\fR\fI'value'\fR |
|
Maximum number of inbound+outbound connections. |
|
.SH JSON-RPC OPTIONS |
|
.TP |
|
\fBserver=\fR[\fI'1'\fR|\fI'0'\fR] |
|
Tells *bitcoin* to accept or not accept JSON-RPC commands. |
|
.TP |
|
\fBrpcuser=\fR\fI'username'\fR |
|
You must set *rpcuser* to secure the JSON-RPC api. |
|
.TP |
|
\fBrpcpassword=\fR\fI'password'\fR |
|
You must set *rpcpassword* to secure the JSON-RPC api. |
|
.TP |
|
\fBrpctimeout=\fR\fI'30'\fR |
|
How many seconds *bitcoin* will wait for a complete RPC HTTP request, after the HTTP connection is established. |
|
.TP |
|
\fBrpcallowip=\fR\fI'192.168.1.*'\fR |
|
By default, only RPC connections from localhost are allowed. Specify as many *rpcallowip=* settings as you like to allow connections from other hosts (and you may use * as a wildcard character). |
|
.TP |
|
\fBrpcport=\fR\fI'8332'\fR |
|
Listen for RPC connections on this TCP port. |
|
.TP |
|
\fBrpcconnect=\fR\fI'127.0.0.1'\fR |
|
You can use *bitcoin* or *bitcoind(1)* to send commands to *bitcoin*/*bitcoind(1)* running on another host using this option. |
|
.TP |
|
\fBrpcssl=\fR\fI'1'\fR |
|
Use Secure Sockets Layer (also known as TLS or HTTPS) to communicate with *bitcoin* '-server' or *bitcoind(1)*. Example of OpenSSL settings used when *rpcssl*='1': |
|
.TP |
|
\fBrpcsslciphers=\fR\fI'TLSv1+HIGH:!SSLv2:!aNULL:!eNULL:!AH:!3DES:@STRENGTH'\fR |
|
.TP |
|
\fBrpcsslcertificatechainfile=\fR\fI'server.cert'\fR |
|
.TP |
|
\fBrpcsslprivatekeyfile=\fR\fI'server.pem'\fR |
|
.TP |
|
.SH MISCELLANEOUS OPTIONS |
|
.TP |
|
\fBgen=\fR[\fI'0'\fR|\fI'1'\fR] |
|
Enable or disable attempt to generate bitcoins. |
|
.TP |
|
\fB4way=\fR[\fI'0'\fR|\fI'1'\fR] |
|
Enable or disable use SSE instructions to try to generate bitcoins faster. |
|
.TP |
|
\fBkeypool=\fR\fI'100'\fR |
|
Pre-generate this many public/private key pairs, so wallet backups will be valid for both prior transactions and several dozen future transactions. |
|
.TP |
|
\fBpaytxfee=\fR\fI'0.00'\fR |
|
Pay an optional transaction fee every time you send bitcoins. Transactions with fees are more likely than free transactions to be included in generated blocks, so may be validated sooner. |
|
.TP |
|
\fBallowreceivebyip=\fR\fI'1'\fR |
|
Allow direct connections for the 'pay via IP address' feature. |
|
.TP |
|
.SH USER INTERFACE OPTIONS |
|
.TP |
|
\fBmin=\fR[\fI'0'\fR|\fI'1'\fR] |
|
Enable or disable start bitcoind minimized. |
|
.TP |
|
\fBminimizetotray=\fR[\fI'0'\fR|\fI'1'\fR] |
|
Enable or disable minimize to the system tray. |
|
.SH "SEE ALSO" |
|
bitcoind(1) |
|
.SH AUTHOR |
|
This manual page was written by Micah Anderson <micah@debian.org> for the Debian system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 or any later version published by the Free Software Foundation. |
|
|
|
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL. |
|
|
|
|