Skip to content

A simple, lightweight, secure, private and verifiable way to deploy your own node with Docker!

License

Notifications You must be signed in to change notification settings

reverse-hash/bitcoin-full-node-with-docker

Repository files navigation

Bitcoin full node with docker

Logo

A simple way to deploy your own node with Docker!

MIT

Documentation | Support | FAQ

About the project

There are many alternatives to set up your own node. Some options seem too crafty and difficult to maintain, and others too customized that add extra complexity that makes auditing the node very difficult.

Since no option was working for me, I decided to create this project and focus on the following points:

  • Simplicity: in the sense that anyone can understand the node arquitecture in a matter of minutes.
  • Lightweight: it can run on a low-resource computer.
  • Secure: it not expose personal data or funds to a possible attacker.
  • Private: communications are encrypted and done anonymously.
  • Verifiable: the build process must be open and simple, so that anyone with a minimum tech-background can verify it.

So here we are and this is what we have:

  • A system to deploy and keep a Bitcoin node up to date in an automated way.
  • No third parties involved. All software is downloaded and verified from official sites.
  • The build process is based on Docker and a few Dockerfiles. No pre-builded images.
  • Everything is built on your local machine and you will verify it.

What to expect

As Bob, you will have a dockerized node to access on your LAN. On port 50002, Electrs will be available to connect Electrum, Sparrow, Bluewallet or any Electrum compatible wallet to check balances and/or broadcast any transaction privately; and via HTTPS on port 3003, BTC RPC Explorer to explore the blockchain.

Your node will participate in the Bitcoin network exchanging blocks with other nodes through Tor; and optionally, it will be accesible from anywhere also through Tor.

The following services are deployed:

Container Service Base image Size
tor Tor 0.4.8.11 debian:stable-slim 83.2 MB
bitcoind Bitcoin core daemon 26.0 debian:stable-slim 80.2 MB
electrs Electrum rust service 0.10.4 debian:stable-slim 82.85 MB
btcrpcexplorer Bitcoin explorer 3.4.0 node:16-slim 333 MB
nginx NGINX stable nginx:alpine-slim 11.5 MB

Documentation

Special thanks and attributions

  • The current logo is a modification of the docker logo from Font Awesome under the (CC BY 4.0). The bitcoin logo has been added and colored orange.
  • Kudos to Emmanuel Rosa for a an initial list of nodes for Tor.
  • Kudos to cozybear-dev for a true multiarch Tor proxy and multiple improvements in documentation/security.

About

A simple, lightweight, secure, private and verifiable way to deploy your own node with Docker!

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published