Zcash.conf Guide

Below contains information for additional configuration of the zcash.conf file.

JSON-RPC Options

Controlling a running Zcash/zcashd process

Parameter Description & Example
addnode

Use as many addnode= settings as you like to connect to specific peers

addnode=69.164.218.197
addnode=10.0.0.2:8233
server

Tells zcashd to accept JSON-RPC commands (set as default if not specified)

server=1
rpcbind
Bind to given address to listen for JSON-RPC connections. Use [host]:port
notation for IPv6. This option can be specified multiple times
(default: bind to all interfaces)
rpcbind=<addr>
rpcuser

You must set rpcuser and rpcpassword to secure the JSON-RPC api

rpcuser=Ulysses
rpcpassword

You must set rpcuser and rpcpassword to secure the JSON-RPC api

rpcpassword=YourSuperGreatPasswordNumber_DO_NOT_USE_THIS
rpcclienttimeout
How many seconds Zcash will wait for a complete RPC HTTP request.
after the HTTP connection is established.
rpcclienttimeout=30
rpcallowip
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 and also because anyone that can authenticate on
the RPC port can steal your keys + take over the account running zcashd
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
rpcport

Listen for RPC connections on this TCP port:

rpcport=83232
rpcconnect
You can use Zcash or zcashd to send commands to Zcash/zcashd
running on another host using this option:
rpcconnect=127.0.0.1

Transaction Fee

Parameter Description & Example
sendfreetransactions

Send transactions as zero-fee transactions if possible (default: 0)

sendfreetransactions=0
txconfirmtarget
Create transactions that have enough fees (or priority) so they are
likely to # begin confirmation within n blocks (default: 1). This
setting is overridden by the -paytxfee option.
txconfirmtarget=n

Miscellaneous Options

Parameter Description & Example
gen

Enable attempt to mine Zcash.

gen=1
genproclimit

Set the number of threads to be used for mining Zcash (-1 = all cores).

genproclimit=1
equihashsolver
Specify a different Equihash solver (e.g. “tromp”) to try to mine Zcash
faster when gen=1.
equihashsolver=default
keypool
Pre-generate this many public/private key pairs, so wallet backups will be valid for
both prior transactions and several dozen future transactions.
keypool=100
paytxfee
Pay an optional transaction fee every time you send Zcash. Transactions with fees
are more likely than free transactions to be included in generated blocks, so may
be validated sooner. This setting does not affect private transactions created with
z_sendmany
paytxfee=0.00