ruimarinho/bitcoin-core

A bitcoin-core docker image.

Supported tags and respective Dockerfile links

• 0.15.0.1, 0.15, latest (0.15/Dockerfile)
• 0.15.0.1-alpine, 0.15-alpine, latest (0.15/Dockerfile)
• 0.14.2, 0.14 (0.14/Dockerfile)
• 0.14.2-alpine, 0.14-alpine (0.14/alpine/Dockerfile)
• 0.13.2, 0.13 (0.13/Dockerfile)
• 0.13.2-alpine, 0.13-alpine (0.13/alpine/Dockerfile)
• 0.12.1-alpine, 0.12-alpine (0.12/alpine/Dockerfile)
• 0.12.1, 0.12 (0.12/Dockerfile)
• 0.11.2-alpine, 0.11-alpine (0.11/alpine/Dockerfile)
• 0.11.2, 0.11 (0.11/Dockerfile)

What is Bitcoin Core?

from bitcoinwiki

Bitcoin Core is a reference client that implements the Bitcoin protocol for remote procedure call (RPC) use. It is also the second Bitcoin client in the network's history.

Usage

How to use this image

This image contains the main binaries from the Bitcoin Core project - bitcoind, bitcoin-cli and bitcoin-tx. It behaves like a binary, so you can pass any arguments to the image and they will be forwarded to the bitcoind binary:

$ docker run --rm -it ruimarinho/bitcoin-core \
  -printtoconsole \
  -regtest=1 \
  -rpcallowip=172.17.0.0/16 \
  -rpcpassword=bar \
  -rpcuser=foo

By default, bitcoind will run as user bitcoin for security reasons and with its default data dir (~/.bitcoin). If you'd like to customize where bitcoin-core stores its data, you must use the BITCOIN_DATA environment variable. The directory will be automatically created with the correct permissions for the bitcoin user and bitcoin-core automatically configured to use it.

$ docker run --env BITCOIN_DATA=/var/lib/bitcoin-core --rm -it ruimarinho/bitcoin-core \
  -printtoconsole \
  -regtest=1

You can also mount a directory it in a volume under /home/bitcoin/.bitcoin in case you want to access it on the host:

$ docker run -v ${PWD}/data:/home/bitcoin/.bitcoin -it --rm ruimarinho/bitcoin-core \
  -printtoconsole \
  -regtest=1

You can optionally create a service using docker-compose:

bitcoin-core:
  image: ruimarinho/bitcoin-core
  command:
    -printtoconsole
    -regtest=1

Image variants

The ruimarinho/bitcoin-core image comes in multiple flavors:

ruimarinho/bitcoin-core:latest

Points to the latest release available of Bitcoin Core. Occasionally pre-release versions will be included.

ruimarinho/bitcoin-core:<version>

Based on a slim Debian image, targets a specific version branch or release of Bitcoin Core.

ruimarinho/bitcoin-core:<version>-alpine

Based on Alpine Linux with Berkeley DB 4.8 (cross-compatible build), targets a specific version branch or release of Bitcoin Core.

Supported Docker versions

This image is officially supported on Docker version 1.12, with support for older versions provided on a best-effort basis.

License

License information for the software contained in this image.

License information for the ruimarinho/docker-bitcoin-core docker project.