Skip to main content

Pi-Node Image & Guide


The guide builds the image from a fresh install of Ubuntu. If you flashed the image you only need the guide as a reference. Head over to the quickstart to get synced up. The relay, core and cold guides will configure the the Pi-Node further.

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 a synced cardano-node. 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'. 🎸



I have found a simple low plrofile usb3 stick works great. For example

Shopping list

  • 2 Pi4B 8GB version.
  • 2 Drives : USB3 stick 256gb or larger
  • A 3'rd 64bit capable Pi as an offline machine(Cold), like a pi-400.
  • Class 10 micro sd card 16GB 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


>_ Terminal
  wget -r -np -nH -R "index.html\*" -e robots=off