Practical overview
When it fits
Use it when a Bitcoin Core node is to run in Docker and the documented image, architecture choices and container configuration fit the deployment.
Who it is for
- Operators deploying Bitcoin Core nodes in Docker.
- Developers who need to run Bitcoin Core in a container and interact with it through Bitcoin Core command-line tools.
Documented uses
- Pull an image for the host's native CPU architecture or choose an architecture-specific image tag.
- Run bitcoind in a container while retaining its data in a host directory.
- Expose the documented RPC, peer-to-peer and ZMQ block and transaction ports.
- Run bitcoind and bitcoin-cli commands inside an active container.
Requirements & limits
The project documents image pulls from Docker Hub and provides its repository under the MIT license.
- The README lists amd64, arm64v8 and arm32v7 binaries; its example pull command selects the host's native architecture, with a separate example for an architecture-specific tag.
- The documented run example maps RPC on 8332, peer-to-peer on 8333, ZMQ block notifications on 28332 and ZMQ transaction notifications on 28333.
- Builds are based on Alpine, and the repository describes automated tag builds, signed tags and OpenTimestamps for tags.
- The README directs users to Bitcoin Core documentation for configuration-file guidance.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Run a Bitcoin command in the container
Issue a documented Bitcoin Core command to a running container.
Before you start
- A running container named bitcoind
Steps
Use docker exec -it bitcoind followed by the binary and command.
For example, run bitcoin-cli -getinfo or bitcoin-cli getblockcount.
Expected outcome
The command is issued to the Bitcoin Core software in the running container.
Guide limitations
- The documented interaction requires the container to be running and named bitcoind.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 15 October 2026
- Original website title
- lncm/docker-bitcoind · Official homepage title · retained in its source language

