Guides
Walk-through guides for RPi4 and Odroid N2, as well as external application guides
Install / Use
/learn @BTCxZelko/GuidesREADME
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.
- 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.
- 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
- For Odroid:
Installation
Once you have obtained your hardware and assembled it, you can choose from a few different installation options:
- Complete Installation of Dojo referred to as Internal Dojo
- RPi4
- Odroid
- Installation of Dojo utilizing an external Bitcoin Core node referred to as External Dojo
- RPi4
- Raspbian
- Manjaro-ARM XFCE(coming)
- Odriod
- RPi4
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!
Related Skills
node-connect
336.5kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
82.9kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
336.5kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
commit-push-pr
82.9kCommit, push, and open a PR
