edebont/bitcoind repository overview

⁠Bitcoind for Docker

Docker image that runs the Bitcoin bitcoind node in a container for easy deployment.

This image is a clone from https://hub.docker.com/r/kylemanna/bitcoind⁠, generated for multiple architectures (amd64, arm64,arm32/v7 & riscv64)

⁠Update Info

2024.09.12 : Upgrade bitcoind in docker image from version 26.0 to 27.1
2024.05.02 : Upgrade bitcoind in docker image from version 26.0 to 27.0 and switched to debian base image
2024.03.24 : Upgrade bitcoind in docker image from version 25.1 to 26.0
2023.11.03 : Upgrade bitcoind in docker image from version 25.0 to 25.1
2023.06.08 : Upgrade bitcoind in docker image from version 24.0.1 to 25.0
2023.01.03 : Upgrade bitcoind in docker image from version 0.24 to 24.0.1 (new version number format)
2022.12.12 : Upgrade bitcoind in docker image from version 0.23 to 0.24 2022.08.13 : Added bitcoind 0.23 riscv64 version
2022.07.21 : Upgrade bitcoind in docker image from version 0.21.0 to 0.23
2021.06.06 : Upgrade bitcoind in docker image from version 0.21.0 to 0.21.1

⁠Requirements

• Physical machine, Raspberry Pi, cloud instance, or VPS that supports Docker (i.e. Vultr⁠, Digital Ocean⁠, KVM or XEN based VMs) running Ubuntu 14.04 or later (not OpenVZ containers!)
• At least 400 GB to store the block chain files (and always growing!). Use external storage (USB disk or NAS share) for Raspberry Pi.
• At least 1 GB RAM + 2 GB swap file

⁠Quick Start

1. Create a bitcoind-data volume to persist the bitcoind blockchain data, should exit immediately. The bitcoind-data container will store the blockchain when the node container is recreated (software upgrade, reboot, etc):

    docker run -v </path/bitcoind-data-folder>:/bitcoin/.bitcoin --name=bitcoind-node -d \
        -e "DISABLEWALLET=1"  \  #optional
        -e "PRINTTOCONSOLE=1"  \ #optional
        -p 8333:8333 \
        -p 127.0.0.1:8332:8332 \
        edebont/bitcoind
   

   Copy

2. Verify that the container is running and bitcoind node is downloading the blockchain

    $ docker ps
    CONTAINER ID        IMAGE                         COMMAND             CREATED             STATUS              PORTS                                              NAMES
    d0e1076b2dca        edebont/bitcoind:latest       "btc_oneshot"       2 seconds ago       Up 1 seconds        127.0.0.1:8332->8332/tcp, 0.0.0.0:8333->8333/tcp   bitcoind-node
   

   Copy

3. You can then access the daemon's output thanks to the docker logs command⁠

    docker logs -f bitcoind-node
   

   Copy

4. Install optional init scripts for upstart and systemd are in the init directory.

⁠Documentation

• Additional documentation can be found in the https://github.com/erik-de-bont/bitcoind/tree/master/docs⁠