Full Dockerized Bitcoin Node.
A Docker configuration with sane defaults for running a fully-validating
Bitcoin node, based on Alpine Linux.
Warning: older versions of this Dockerfile were based on Ubuntu and
included all build dependencies, but due to the ridiculous size of the
resulting image I’ve moved to binaries downloaded to Alpine Linux. If I’ve
screwed up your development workflow somehow, file an issue and we’ll get it
fixed.
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 \
nexbitio/bitcoind
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:
name | default |
---|---|
BTC_RPCUSER | btc |
BTC_RPCPASSWORD | changeme |
BTC_RPCPORT | 8332 |
BTC_RPCALLOWIP | ::/0 |
BTC_RPCCLIENTTIMEOUT | 30 |
BTC_DISABLEWALLET | 1 |
BTC_TXINDEX | 0 |
BTC_TESTNET | 0 |
BTC_DBCACHE | 0 |
BTC_ZMQPUBHASHTX | tcp://0.0.0.0:28333 |
BTC_ZMQPUBHASHBLOCK | tcp://0.0.0.0:28333 |
BTC_ZMQPUBRAWTX | tcp://0.0.0.0:28333 |
BTC_ZMQPUBRAWBLOCK | tcp://0.0.0.0:28333 |