Awesome Open Source
Awesome Open Source

Bitcoind for Docker

Docker Stars Docker Pulls Build Status ImageLayers

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


  • Physical machine, 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 100 GB to store the block chain files (and always growing!)
  • At least 1 GB RAM + 2 GB swap file

Recommended and tested on unadvertised (only shown within control panel) Vultr SATA Storage 1024 MB RAM/250 GB disk instance @ $10/mo. Vultr also accepts Bitcoin payments!

Really Fast Quick Start

One liner for Ubuntu 14.04 LTS machines with JSON-RPC enabled on localhost and adds upstart init script:

curl | sh -s trusty

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 volume create --name=bitcoind-data
     docker run -v bitcoind-data:/bitcoin/.bitcoin --name=bitcoind-node -d \
         -p 8333:8333 \
         -p \
  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        kylemanna/bitcoind:latest     "btc_oneshot"       2 seconds ago       Up 1 seconds>8332/tcp,>8333/tcp   bitcoind-node
  3. You can then access the daemon's output thanks to the docker logs command

     docker logs -f bitcoind-node
  4. Install optional init scripts for upstart and systemd are in the init directory.


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
shell (10,536
docker (2,967
docker-image (392
vultr (17