Docker Knots

Docker images of Bitcoin Knots for the linux/amd64 and linux/arm64 architectures.

The images are based on Alpine Linux and run bitcoind without a configuration file.

The datadir is at the default /home/bitcoin/.bitcoin location. This directory is designated as a Docker volume.

This is the images' default ENTRYPOINT. Adjust the CMD if you want to run the bitcoind daemon with a different configuration.

ENTRYPOINT ["/usr/local/bin/bitcoind", "-nodebuglogfile", "-zmqpubhashblock=tcp://0.0.0.0:8443", "-zmqpubrawblock=tcp://0.0.0.0:28332", "-zmqpubrawtx=tcp://0.0.0.0:28333"]

Customization example based on Docker Compose v2:

name: knots-signet

services:
  knots:
    image: 1maa/bitcoin:v29.1.knots20250903
    command: -signet -txindex=1

Available Versions

• 1maa/bitcoin:latest
• 1maa/bitcoin:signet-miner
• 1maa/bitcoin:v29.2.knots20251110
• 1maa/bitcoin:v29.2.knots20251010
• 1maa/bitcoin:v29.1.knots20250903
• 1maa/bitcoin:v28.1.knots20250305
• 1maa/bitcoin:v27.1.knots20240801

Deterministic Build Guide

The binaries contained in these images are built automatically from source using GitHub actions, but they are not deterministic.

For a step-by-step guide to do a deterministic build of Bitcoin Knots and attest the resulting binaries with your PGP key check out the Guix guide.

Signet Miner

The image variant 1maa/bitcoin:signet-miner contains the contrib/signet CPU miner for signet networks.

For an example on how to use this image refer to the miner service in the compose.yml file of the signet-playground repository.