Skip to main content

Tutorial: Running an Ergo Full Node on a Headless Raspberry Pi

A tutorial on how to setup and run an Ergo Full Node on a Headless Raspberry Pi.

test1

A headless raspberry pi (pi, raspi, or raspberrypi) does not have a monitor or mouse plugged in. Instead, you are securely remoted into the pi via the terminal command line.

This is geared toward beginners who want to learn and hopefully get more Ergo nodes running! See ErgoNodes.net.

Don't worry, it's not that hard, and you will feel super cool afterwards.

The tutorial includes:

Part 1: Headless Raspi Setup & Login​

  • Hardware Shopping List
  • Brief Intro to Headless Command Line Interface (CLI)
  • Flash Setup & Configuration of the Pi
  • Secure Shelling into the Pi
  • Setup External Storage USB

Part 2: Ergo Full Node Configure & Run​

  • Setup & Configure the Pi for Ergo Node
  • Headless Ergo Node setup
    • goal is for nipopow bootstrap setup
  • Run the node in the background thru a tmux session

Part 3: Run the Node in the Background as a tmux Session​

  • Why is this needed (ssh connection breaks when computer sleeps)
  • What is a tmux session?
  • Run the node syncing in the background as a tmux session

Part 4: Robustly run the node in the background as a systemd​

  • Robustly configure the rpi to run the node upon startup, restart, and in the background
  • Port forwarding to get incoming peer connections (not just outgoing)

Part 5: Satergo Wallet Full Node Wallet Setup​

  • Setup wallet in the Ergo Node Explorer
  • Setup wallet in Satergo w/ remote node into the rpi
  • Enjoy the beautiful Satergo wallet gui on your local machine

Ergo Full Node Resources​

A cheatsheet and comprehensive list of references.

Issues, Improvements, Help​

This project is still in work #buildinginpublic

If anything doesn't work or needs clarification, open a github Issue, or fork and submit a pull request update.

If you need help, DM me on twitter @thestophe or find me in the Matrix #ergomatrix:matrix.org.

Too Much Work - Something Easier!​

A really simple and nice option is to just use Satergo full node wallet.

You can just download and run it, batteries included. If you don't have the computer memory storage, you can reference a "remote" full node.

This is a great option, plus the UI/UX is beautiful.

Special Thanks​

Appreciate the help from the following folks and resources!

Donations or Staking​

If you find this tutorial helpful, here's my donation tip jar! #Ergo2Top10

donations-qr-code

9htXsxhTNpt8LaSdLF5PDqNe99RaXmMRTAJu3iTB57ivxx3UNFa

Or better yet, if an $ADA hodler too, Stake to BALNC Pool! We provide high quality on-chain analysis and data visualization using Svelte: https://www.balanceanalytics.io/. Cheers!

Questions?​

Feel free to jump into our Ergo - BALANCE room to chat and ask questions. This chat is in the Matrix.org open source commmunication protocol, we recommend using the Element Client.