Skip to content
A Docker image used to run an BCH ABC full node inside a Docker container.
Dockerfile Shell JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.env Adding .env file Jun 29, 2019
Dockerfile feat(ABC v0.20.0): Updated for ABC v0.20.0 Sep 1, 2019
LICENSE.md Forking rom docker-abc-rpi Apr 10, 2019
README.md
bitcoin.conf feat(ABC v0.20.0): Updated for ABC v0.20.0 Sep 1, 2019
cleanup-images.sh Forking rom docker-abc-rpi Apr 10, 2019
docker-compose.yml Switching to docker hub image Sep 2, 2019
dummyapp.js Forking rom docker-abc-rpi Apr 10, 2019
enter-image.sh moving towards specific images Jul 8, 2019
run-script.sh
startup-script.sh feat(ABC v0.20.0): Updated for ABC v0.20.0 Sep 1, 2019

README.md

docker-abc

A BCH full node based on the ABC reference implementation. This repo has a sister repo, docker-abc-rpi, which is the same idea but targeted for a Raspberry Pi v3 B+ minicomputer.

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

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 https://github.com/christroutner/docker-abc

  • 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 run-script.sh 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/bch-mainnet-abc-rpi/debug.log

  • Or query the JSON RPC:

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

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

Customization

  • 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.

Testnet

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

License

MIT License

You can’t perform that action at this time.