Dockerizing Bitcoin

4 mins

almost 6 years ago

Francis Pouliot
Francis Pouliot


Dockerizing Bitcoin

Dockerizing Bitcoin

It’s just the begining: let’s dockerize all the Bitcoin projects!

It’s just the beginning: let’s dockerize all the Bitcoin projects!

I’m very excited to have finally open-sourced the first part of Satoshi Portal’s custom Bitcoin infrastructure: our repository of Bitcoin-related dockerfiles and configurations upon which our web applications are built and they are the building blocks of our Cyphernode project (more on that in my next post!) Because we love Docker and Bitcoin so much, we decided dockerize all the Bitcoin projects! This includes Bitcoin Core and Lightning Nodes, as well as various utilities like OpenTimestamps and PyCoin.

This is the website for our repository: SatoshiPortal/dockers which is where we will publish all the Bitcoin docker container projects that we either coded or reviewed. They each come with a tutorial.

All the current dockerfiles are used in production by Bylls and Bitcoin Outlet, Satoshi Portal’s Bitcoin financial services applications. In other words: they are currently being used to send and receive bitcoins commercially on the main net.

Docker is an amazing technology which allows developers to build and deploy scalable web applications. A Docker container image is a lightweight, standalone, executable package of software that includes everything needed to run an application. Using our dockers will save you a lot of time and effort, but you also benefit from existing best practices and don’t have to reinvent the wheel. We ourselves tried to create the least now code possible, using the best standards and open-source software, and with security-by-default because we are running Bitcoin exchange applications that are an obvious high-value target for attackers.

We spent time to develop our own techniques and configurations for ourselves, embedding our philosophies. If you plan on using Bitcoin dockers, we encourage you to have a look at the work we have done so that you can better allocate your time and resources.

We hope that by creating docker containers of useful and popular Bitcoin open-source software projects, we will make it easier for developers and project managers to build applications on top of Bitcoin. If you need help or have requests don’t hesitate to reach out using the contribution guidelines below.

We will be continuously adding more Bitcoin Dockers, and maintaining and updating these images. Don’t hesitate to contact us if we haven’t yet done the updates that you need.

Contributions are welcome! We hope you find this useful and we look forward to your feedback, questions and comments (on Github).

Features and philosophy

  • Lightweight alpine-based docker containers that were designed to run on small devices with some optimized specifically for Rapsberry Pi.
  • Using the least new code possible and re-using existing OS built-in and well-known and review open-source software projects.
  • Using container OS as running platform instead of language-based interpreter.
  • Security by default: Encrypting everything through Docker Encrypted Overlay Network
  • Distributing everything through Docker Swarm to maximize scalability
  • Exposing nothing outside the overlay network.

List of existing Dockerfiles

We’re starting out with the software we are using right now. As soon as we have more time we will be adding more.


We are definitely looking for contributions! Get inspired by the existing work. Don’t be afraid to test, explore, and do pull-requests. We are all learning this as we go along. Don’t just copy-paste: try to understand what you are doing. Ask questions and provide feedback!

If you are running our dockers in your applications you can send us emails at for private assistance but making an issue on or pull request on Github is the fastest and most efficient way to reach us.


If you want us to add a docker, please create an issue this way:

  • Paste the source code of the repository you want us to add
  • Tell us why you think this is useful and/or how you (or you think someone else) may want to use it. This will help us prioritize and think of the actual usage.
  • Put the label “wishlist” on the issue.

Tell us what you want and why!

Tell us what you want and why!

Special thanks to Kexkey who did all the work.

Satoshi Portal is Made with love in Montreal

Made with love in Montreal

Related Posts

Learn more from the following articles

Bull Bitcoin Partners with Bitcoin Mentor for Enhanced Bitcoin Education and Integration (FR)

2 mins

21 days ago

Bull Bitcoin Partners with Bitcoin Mentor for Enhanced Bitcoin Education and Integration

Article Card Excerpt: Bull Bitcoin and Bitcoin Mentor Announce Strategic Partnership Bull Bitcoin, Canada's premier Bitcoin-only exchange, partners with Bitcoin Mentor to provide users with expert Bitcoin education and secure self-custody guidance. This collaboration aims to enhance the Bitcoin experience for all users through integrated support and personalized mentorship.

Mathieu Bussière
Mathieu Bussière


The Hard Path
OpinionScaling Bitcoin

6 mins

2 months ago

The Hard Path

Bull Bitcoin takes the hard path to uphold Bitcoin's true values. Rejecting easy profits from custodial wallets, shitcoins, and NFTs, we focus on creating sovereign individuals through noncustodial services. We build open-source software and support local Bitcoin economies. Despite challenges, we maintain a steadfast commitment to Bitcoin's mission of decentralization, privacy, and self-custody, striving for long-term success and integrity.

Francis Pouliot
Francis Pouliot


A Primer on UTXOs

5 mins

2 months ago

A Primer on UTXOs

The fundamental elements of Bitcoin’s accounting system are transactions with inputs, outputs, and amounts (in satoshis). The input is either a coinbase transaction (newly mined bitcoin), or the output of a prior transaction which hasn’t been spent already, called an Unspent Transaction Output (UTXO). In this article, Theo Mogenet walks us through the structure of a Bitcoin transaction, the associated fees and how to consolidate your UTXOs.

Théo M
Théo M

Europe GM, Bull Bitcoin

BuySellFeaturesRates & Fees
Self-custody SupportShop PackagesBuy for a friendDIY