Docker image that runs the Bitcoin Bitcoin Cash node in a container for easy deployment.
- Physical machine, cloud instance, or VPS that supports Docker (i.e. Hetzner, Vultr, Digital Ocean, KVM or XEN based VMs) running Ubuntu 14.04 or later (not OpenVZ containers!)
- At least 100 GB to store the block chain files (and always growing!)
- At least 1 GB RAM + 2 GB swap file
One liner for Ubuntu 14.04 LTS machines with JSON-RPC enabled on localhost and adds upstart init script:
curl https://raw.githubusercontent.com/mahsumurebe/docker-bch-bitcoind/master/bootstrap-host.sh | sh -s trusty
-
Create a
bitcoin-cash-data
volume to persist the Bitcoin Cash Daemon blockchain data, should exit immediately. Thebitcoin-cash-data
container will store the blockchain when the node container is recreated (software upgrade, reboot, etc):docker volume create --name=bitcoin-cash-data docker run -v bitcoin-cash-data:/bitcoin/.bitcoin --name=bitcoin-cash-node -d \ -p 8333:8333 \ -p 127.0.0.1:8332:8332 \ mahsumurebe/bitcoin-cash
-
Verify that the container is running and Bitcoin Cash node is downloading the blockchain
$ docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES d0e1076b2dca mahsumurebe/bitcoin-cash:latest "btc_oneshot" 2 seconds ago Up 1 seconds 127.0.0.1:8332->8332/tcp, 0.0.0.0:8333->8333/tcp bitcoin-cash-node
-
You can then access the daemon's output thanks to the docker logs command
docker logs -f bitcoin-cash-node
-
Install optional init scripts for upstart and systemd are in the init directory.
- Additional documentation in the docs folder.