btcxzelko / guides

Walk-through guides for RPi4 and Odroid N2, as well as external application guides

Ronin Dojo Guides

These guides are no longer updated. See our project at

https://code.samourai.io/ronindojo/RoninDojo

Ronin Dojo is the RPi4 and Odriod N2 installation variant of Samourai Wallet's Dojo. This is not a change to their code or application, rather the installation process modified specifically for RPi4/Odroid.

Our Mission is to bring full on-chain self-sovereignity at an afforable price!

A Ronin was a samurai warrior in feudal Japan without a master or lord — known as a daimyo. A samurai could become a ronin in several different ways: his master might die or fall from power or the samurai might lose his master's favor or patronage and be cast off.

Miyamoto Musashi, also known as Shinmen Takezō, Miyamoto Bennosuke or, by his Buddhist name, Niten Dōraku, was a Japanese swordsman, philosopher, strategist, writer and rōnin. Musashi, as he was often simply known, became renowned through stories of his unique double-bladed swordsmanship and undefeated record in his 61 duels.

Be Your own MASTER!

What is Samourai Dojo?

As stated by the Samourai Team:

Samourai Dojo is the backing server for Samourai Wallet. Provides HD account & loose addresses (BIP47) balances & transactions lists. Provides unspent output lists to the wallet. PushTX endpoint broadcasts transactions through the backing bitcoind node.

This implementation connects to your wallet via Tor for increased privacy and allowing for connectivity anywhere without forwarding ports and exposing your home IP address.

For more information on Samourai Wallet, Dojo, and Whirlpool visit the Samourai Wallet Github.

For FAQ's about all things Samourai Wallet, check out @PuraVida's FAQ wiki

Recommended Hardware

The Full Dojo installation, which includes a fresh sync of the Bitcoin blockchain, requires a little over 3GB of RAM during the initial sync. Then it drops to a little less than 2GB after sync is complete. Thusly we recommend: Odroid N2 or the Raspberry Pi4.

NOTE: We do not endorse any particular supplier or product.

External Drives

Given the increased performance and longevity of use: we recommend 1TB SSD such as: Samsung T5 or Seagate Fast SSD.

However, if you are looking to run a node a budget, you can use external HDD's such as: Toshiba Canvio 1TB or Seagate Expansion 1TB.

Do your own research to find out which SSD/HDD you believe is best for you, these are recommendations.

SD cards

You'll need a SD card to flash the OS of choice (we will cover Raspbian and Manjaro-ARM). For this we recommend: Samsung EVO+ 64GB. You'll need at least 16GB but for the price this is a great deal for a high quality SD card.

Flashing Operating System

This guide will cover: Raspbian Manjaro Minimal Manjaro Desktop GUI, and

Debian Installations. Follow the links for more information and installation instructions.

For Manjaro-Arm: NOTE: The XFCE is the desktop version and Minimal is best for headless use. The XFCE version is resource heavy and will likely not be able to handle Dojo+Whirlpool+Electrs. For that option install Minimal

Cases

We strongly recommend getting a case that keeps the Pi or Odroid cool.

1. For RPi4:
   • For a Custom Samourai Wallet Ronin Dojo Case, we highly recommend CrytpoCloak! Comes with storage for Pi4 AND external storage device (check size requirements) Check it out here
     • NOTE: WE DO NOT RECEIVE COMPENSATION FOR THEIR PRODUCT, but an awesome product at that.

• Either with active cooling cases such as:Flirc
• Or a case with a fan such as Miuzei

2. For Odroid:
   • KSSB Case
   • ODROID-N2 Case

Installation

Once you have obtained your hardware and assembled it, you can choose from a few different installation options:

1. Complete Installation of Dojo referred to as Internal Dojo
   • RPi4
     • Raspbian
     • Manjaro-ARM XFCE
     • Manjaro-ARM Minimal
   • Odroid
     • Debian
2. Installation of Dojo utilizing an external Bitcoin Core node referred to as External Dojo
   • RPi4
     • Raspbian
     • Manjaro-ARM XFCE(coming)
   • Odriod
     • Debian

Contributors

This list is continuously growing, I will do my best to update as much as I can. If you would like to contribute please feel free to pull or DM me to help!

@GuerraMoneta @Burcakbaskan @bavarianledger @k3tan @pornaulait @crazyk031 @jaimefoo

@romanz - Electrs

@openoms and @rootzoll - Raspiblitz team for inspiration and Electrs implementation.

If I missed you please let me know.

Shout out to Samoura Wallet team for making an amazing product!