Skip to content


Repository files navigation


A BCH full node based on the ABC reference implementation.

This repository specifically targets the hard drive and micro-server platform described at

Installation and Usage

  • It's assumed that you are starting with a fresh installation of Ubuntu 18.04 LTS on a 64-bit machine. It's also assumed that you are installing as a non-root user with sudo privileges.

  • Install Docker on the host system. This tutorial shows how to install Docker on a Ubuntu system. It's specifically targeted to Digital Ocean's cloud servers, but should work for any Ubuntnu system.

  • Install Docker Compose too. This tutorial shows how to do so on a Ubuntu system.

  • Clone this repository in your home directory with the following command:

git clone

  • Create a two directories in the same directory docker-abc. These will be used to store configuration data and blockchain data. Call them:

    • config
    • blockchain-data
  • Copy the and bitcoin.conf file into the config directory you just created. Customize the bitcoin.conf file for your own full node.

  • Enter the docker-abc directory and start the container with this command:

docker-compose up -d

  • Check on the status of bitcoind as it syncs to the blockchain:

`sudo tail ../blockchain-data


  • Or query the JSON RPC:

curl --data-binary '{"jsonrpc":"1.0","id":"curltext","method":"getnetworkinfo","params":[]}' -H 'content-type:text/plain;' http://bitcoin:password@

curl --data-binary '{"jsonrpc":"1.0","id":"curltext","method":"getblockchaininfo","params":[]}' -H 'content-type:text/plain;' http://bitcoin:password@


  • Customize the volumes setting in the docker-compose.yml file in order to choose where you want the blockchain data and config files stored.

  • Edit the bitcoin.conf file in the config directory and restart the container if you need to change the configuration settings for the full node.


This repository has a hd-testnet branch that customizes the files in this repository for testnet.


MIT License


A Docker image used to run an BCH ABC full node inside a Docker container.







No releases published


No packages published