Public | Automated Build

Last pushed: a year ago
Short Description
Full Description


Run with just a couple commands

Also on

Quick Setup with Docker

  1. Open port 8233 on your router
  2. Install Docker from
  3. Install rocker-compose from
  4. In a terminal, run the following:

     git clone
     cd dockerfile-zcash
  5. Edit the mainnet.conf with a more secure password and maybe enable mining.

  6. In a terminal, run the following to start zcash:

     rocker-compose pull
     rocker-compose run
  7. Watch the logs:

     docker logs -f zcash.mainnet
  8. Once the params have finished downloading and the daemon has started, using zcash-cli is easy:

     ./bin/zcash-cli help
     ./bin/zcash-cli getinfo
     ./bin/zcash-cli getpeerinfo
  9. Back up your wallet!

     cp ./data/mainnet/wallet.dat /backups/somewhere/safe
  10. Start mining:

    # to mine on all cores (this will make your computer hot)
    ./bin/zcash-cli setgenerate true -1
    # to mine on 1 cores (this will make your computer not as hot)
    ./bin/zcash-cli setgenerate true 1
  11. Stop mining

    ./bin/zcash-cli setgenerate false

IMPORTANT! The wallet encryption feature is disabled in zcashd so be careful!

Doing more

Run commands against the container:

docker exec -it zcash.mainnet bash -l

docker exec -it zcash.mainnet free -h
docker exec -it zcash.mainnet nproc

docker exec -it zcash.mainnet zcash-cli help
docker exec -it zcash.mainnet zcash-cli getinfo
docker exec -it zcash.mainnet zcash-cli zcbenchmark solveequihash 10
docker exec -it zcash.mainnet zcash-cli zcbenchmark solveequihash 20
docker exec -it zcash.mainnet zcash-cli setgenerate true 1

zcashd -daemon -stratum=poolstratum -user=username.worker -password=yourpass -debug -printtoconsole
zcashd -stratum=stratum+tcp://  -user=bitbuyio.zec-linux -password=x -debug -printtoconsole

~/zcash/./src/zcashd -daemon (start wallet)
~/zcash/./src/zcash-cli getinfo (check wallet info, blockchain etc)
~/zcash/./src/zcash-cli keypoolrefill 10000 (create 500 addresses for mining default:100)
time ~/zcash/src/zcash-cli zcbenchmark solveequihash 10 (10 benchmark runs)
~/zcash/./src/zcash-cli listtransactions (list mined coins)
~/zcash/./src/zcash-cli stop (stop miner)
~/zcash/./src/zcash-cli zcrawkeygen - to generate anon wallet (transparent coins to anon coins)
~/zcash/./src/zcash-cli z_listaddresses (list anon addresses)
~/zcash/./src/zcash-cli listunspent (list unspent)
~/zcash/./src/zcash-cli zcrawkeygen (create anon addie)
~/zcash/./src/zcash-cli zcrawjoinsplit "$(~/zcash/./src/zcash-cli createrawtransaction '[{"txid":"TransparentAddieofBlock","vout":0}]' '{}')" '{}' "{"AnonAddressYouWantToSendTo":1}" 1 0
~/zcash/./src/zcash-cli signrawtransaction "$RAWTXN_FROM_ZCRAWJOINSPLIT"
~/zcash/./src/zcash-cli sendrawtransaction "$RAWTXN_FROM_SIGNRAWTRANSACTION"


Build the image

docker build . -t bwstitt/zcash


  • [ ] helper to customize config
  • [ ] expose ports
  • [ ] easily switch between mainnet and testnet and regtest
  • [ ] use rocker-compose inside a container so that it doesn't need to be installed on the host
  • [ ] use Tor


Donations are much appreciated!

  • Bryan Stitt <bryan at>
    • Bitcoin: 17vi3UfTYNRi6RnWRbhv7nXBH66c4gVYEV
    • Zcash: t1NEaED2QeEYckpc3WGdQrn2yPV9ujwk5gr
    • Zcash: zcGWtivu6xbzE9rdKaxFHXy9TjDsu1tw76sxGp83SCVeYn8DwRYNsWfexqhuvSWvr411V3niiwWRkCcTu8Xm2hVKhkQzFB6
Docker Pull Command
Source Repository