tiberiuc/bitcoind repository overview

⁠docker-bitcoind

A Docker configuration with sane defaults for running a fully-validating Bitcoin node, based on Alpine Linux⁠.

Full support for regtest and backup-agent⁠

Wallet notify support by running curl with the address from env BTC_WALLET_NOTIFY sending a JSON in format { "txid": "...txid..." }

⁠Quick start

Requires that Docker be installed⁠ on the host machine.

# Create some directory where your bitcoin data will be stored.
$ mkdir /home/youruser/bitcoin_data

$ docker run --name bitcoind -d \
   --env 'BTC_RPCUSER=foo' \
   --env 'BTC_RPCPASSWORD=password' \
   --env 'BTC_TXINDEX=1' \
   --volume /home/youruser/bitcoin_data:/root/.bitcoin \
   -p 127.0.0.1:8332:8332 \
   --publish 8333:8333 \
   --publish 9191:9191 \
   tiberiuc/bitcoind

$ docker logs -f bitcoind
[ ... ]

⁠Configuration

A custom bitcoin.conf file can be placed in the mounted data directory. Otherwise, a default bitcoin.conf file will be automatically generated based on environment variables passed to the container:

⁠Daemonizing

Currently bitcoind is run inside supervisor

⁠Backup and restore

Backup

curl http://localhost:9191/backup -o bitcoin.tgz

Restore

curl http://localhost:9191/restore --data-binary @./bitcoin.tgz