Bitcoin Core Container

• About
• Usage
  • Run
  • Compose
• Building
• Contributing
• Core Maintainers
• License
• Copyright

About

This project builds images of Bitcoin Core for use as Podman or Docker containers. It has support for the following platforms:

• amd64
• arm64
• arm32v7

The examples in this document use the podman command. Just swap with the docker command if you are using Docker.

Usage

To run a container, use either podman run or define a service in a compose.yaml file.

Run

To run with podman run:

podman run -v ./bitcoin:/home/bitcoin/.bitcoin -p 8333:8333 code.fosterhangdaan.com/foster/bitcoin-core-container:latest

Compose

To define a service in a compose.yaml file:

version: "3.8"

services:
  bitcoin-core:
   image: code.fosterhangdaan.com/foster/bitcoin-core-container:latest
   container_name: bitcoin-core
   restart: unless-stopped
   volumes:
     - ./bitcoin:/home/bitcoin/.bitcoin
   ports:
     # RPC
     - 8332:8332
     # P2P
     - 8333:8333
     # ZMQ block notifications
     - 28332:28332
     # ZMQ transaction notifications
     - 28333:28333

Building

To build the image:

podman build --platform='linux/amd64' .

Set the os/arch of the built image with the --platform option. It accepts one of the following values:

linux/amd64

for amd64

linux/arm64

for arm64

linux/arm/v7

for arm32v7

Contributing

Please send patches and bug reports by email to one of the maintainers. See the Core Maintainers section for a list of contacts.

Refer to this guide if you are not familiar with sending Git patches over email.

Core Maintainers

• Foster Hangdaan

  • Website: www.fosterhangdaan.com
  • Email: foster@hangdaan.email
  • GPG Public Key: DBD3 8E38 4B9E 1F4F 19F9 5BAE E48D 7F49 A852 F112
  • OpenAlias: pay.fosterhangdaan.com

License

Licensed under the Apache License, Version 2.0. See LICENSE.txt.

Copyright

Copyright 2023 Foster Hangdaan