Pi-Node Image & Guides🍰

A guide to building a 4 watt per Pi, Cardano Stake Pool. A reference guide for the Pi-Node.img.gz.

The Pi-Node.img.gz is a pre configured Cardano node that can be used for minting NFT's, submitting transactions and can be further configured into a relay or core node for stake pool creation. It is configured with everything you need to quickly bootstrap a synced node with Nginx proxypass of Grafana for TLS encryption with a self signed certificate, working topology updater and gLiveView.

It is strongly recommended to work through the Stake Pool School course presented by the Cardano Foundation.

If you would like to create a .img file of your work that can be flashed for reuse on other Raspberry Pi's you should build on an 8GB sd card. It will take less time to make an image. See image creation section.

Why this guide?

Consolidate and organize the various guides into a single document that can be followed or referenced specifically for running a pool using two (or more) Raspberry Pi 4B (the 8GB version) and one offline Pi for cold key operations.

Provide documentation of every step taken while building the Pi-Node image available for bootstrapping pool creation. A reference & guide.

The most popular guides out there are aimed at x86 architecture and 'knowing what to throw away and knowing what to keep' is not always clear. I aim to change that 'with a little help from my friends'. 🎸


The cardano-node & cardano-cli binaries linked to in this guide require aarch64 architecture to run. You must use Pi4B 8GB for the Core & Relays, you can use the Pi3B+ or PI4B 4GB or 8GB version with a micro sd card for your cold offline machine.

Shopping list

  • 2 Pi4B 8GB version.

  • 2 Drives : (NVMe low power, form & speed).

  • M.2 key to USB3.1 adapter or whatever works with your drive.

  • A 3'rd 64bit capable Pi as an offline machine(Cold).

  • Class 10 micro sd card 8GB or larger.

  • Extra USB flash drives for backing up keys and configurations.

  • Consider a single 50+ watt power supply

  • Consider a 5 volt gigabit switch

  • Consider a case with a fan

Credit & community