¶ Introduction
If you are a RoninDojo v1.15.1 (or earlier) bitcoin node user, then you must reflash to update to v2.0.1, and this guide is for you!
In RoninDojo v1.x the base Operating System was Manjaro ARM (Arch).
Starting with v2.x the base Operating System is Armbian (Debian).
This will bring with it significant stability improvements and more reliable releases. But as a result, any user who is on the legacy v1.x must perform a reflash to the latest RoninOS to get continued updates and support.
¶ What is required by you?
- Reflash the microSD
- Re-connect your Samourai Wallet
- Re-initialize Whirlpool CLI to continue remixing
¶ Instructions For Upgrading to RoninOS v2.0.1
The RoninOS v2.0.1 image is Plug 'N' Play.
There is no longer a requirement to SSH into your RoninDojo node after re-flashing to set anything up!
Instead follow the instructions below step-by-step.
¶ Step 1: Power down your RoninDojo
- Login to your RoninUI, then go to:
Dashboard>RoninDojo>Manage>Shut down device
¶ Step 2: Reflash the microSD from your node
- Tanto, Bokuto, Rockpro64: Follow the MicroSD Reflashing Guide in the wiki.
- Raspberry Pi: There is a DIY community provided guide available.
¶ Step 3: Wait for your node to catch back up
The blockcahin data and indexer data will be salvaged. You just need to wait for them both to catch up to the latest blockheight.
Before continuing to the next step, wait for the following to be displayed within your RoninUI:
- Dojo 100% Synchronized
- Bitcoin Core 100% Synchronized
- Indexer 100% Synchronized
Notice: If Dojo does not reach 100% Synchronized, restart Dojo from within your RoninUI by going: Dashboard > Dojo > Manage > Restart, then wait for Dojo to reach 100% before continuing to Step 9.
¶ Step 4: Reconnect your Samourai Wallet
Use the following guide to reconnect your existing Samourai Wallet to your RoninDojo node:
¶ Step 5: Pair your Samourai Wallet to Whirlpool CLI running on your RoninDojo
First open your Whirlpool GUI desktop application:
- Go to the
Systemsettings, and click onReset GUI
Then follow the instructions here to connect your Samourai Wallet to your Whirlpool GUI / Whirlpool CLI:
¶ Step 6: Updated .onion URLs
Finally, now you have upgraded to RoninDojo v2.0.1, the following .onion URLs will have changed:
-
RoninUI
Dashboard>RoninDojo>Manage -
Mempool (if installed)
Dashboard>Mempool Space
Don't forget to update any bookmarks you have!
¶ FAQs
- Why is a reflash required?
- It is only possible to move to a Debian based operating system by reflashing.
- Is the v2.0.1 image plug 'n' play?
- For RockPro64 users, yes. After placing the flashed microSD back in your node and applying power, automatic installation and initialization will be carried out. This is new and a lot quicker to get back up and running.
- For Raspberry Pi users, no.
A Raspberry Pi image is currently unavailable for v2.0.1.
- Will my node have to download the entire blockchain again after upgrading?
- No your IBD will be salvaged. Then any missing blocks from your node's downtime will be downloaded once it is operational again.
- Will I have to wait for indexing of the bockchain to be carried out after upgrading?
- No. Your current indexer data will be salvaged. Then any missing blocks from your node's downtime will be indexed once it is operational again.
- I am currently running Electrs / Fulcrum as my indexer. Will the .onion URL change?
- No. After upgrading it will remain the same. If you had Sparrow connected to your node previously, you will not need to change the server details within the Sparrow server settings.
- Will the RoninUI .onion URL change?
- Yes. Don't forget to bookmark your new RoninUI .onion URL for remote access over Tor.
- I currently have Bisq / Mempool installed. Will they still be installed after upgrading?
- Yes. Although the Mempool .onion URL will change, so don't forget to bookmark it.
- Will I need to re-connect my Samourai Wallet after upgrading?
- Yes. We have a shortcut method for that however, so manual rescans should not be required. (Instructions above).
- I am currently using Whirlpool on my node. Will I lose access to these coins, or have to do anything after upgrading?
- Your bitcoin in Whirlpool is controlled by your private keys on Samourai Wallet. You will not loose access to any bitcoin. After reconnecting your Samourai Wallet to your upgraded node, you will need to reconfigure the Whirlpool CLI on your node to pick up from where you left off and continue mixing/remixing. (Instructions below).