RoninDojo
Data
Page Contents
Basic Data Troubleshooting
Salvaging Data
Use Backup Drive for Recovery
Advanced Data Troubleshooting
Secondary Backup Drive
Copy Data from Other Node to RoninDojo
WinSCP Copy Data from Windows11 to RoninDojo
Additional Info
Tags
backupdatasdrecoverysalvage
Last edited by
Editor
08/20/2025

Basic Data Troubleshooting


Salvaging Data

In most cases of device malfunction your data is perfectly safe. Many problems can be easily resolved by doing a reflash of the microSD card, and the RoninDojo software will take care of the rest.

Rest easy as this means you most likely will not need to redownload the entire bitcoin blockchain, redo your bookmarks, and update your password manager.


Use Backup Drive for Recovery

If you plug in your secondary backup drive that contains your data while setting up a device that has a wiped SSD or new SSD, then your backup drive will automatically be detected and used to salvage your RoninDojo data. Expect the data transfer to take a long time, come back later to check the RoninUI and see if it has completed.


Advanced Data Troubleshooting

TIP: The following troubleshooting sections may be considered advanced to newer users.


Secondary Backup Drive

By following the guide below, you will be able to use a secondary drive to store a copy of the blockchain from your RoninDojo. This method can be used to transfer data between two different RoninDojos. Also if RoninDojo ever has a massive failure, having this data on hand will reduce your setup time when starting over.

If done correctly, you could reduce setup time from days to just a few hours. This is because the blockchain takes such a long time to download when starting over.


Setup New Backup Drive:

  1. NOTICE: You only need to do this step once! All existing data on this new backup drive will be erased when it is formatted for blockchain data backups.

  1. Connect your new backup SSD or HDD to your RoninDojo. Go to the RoninCLI command line menu and select the format new backup drive option.

         System → Disk Storage → Format & Mount New Backup Drive


  1. Your new backup drive is now formatted and ready! Please proceed to steps below.

Send Blockchain Data to Backup Drive:

  1. Connect your backup SSD or HDD to your RoninDojo. Go to the RoninCLI and select the option to send data to the backup drive.

         Dojo → Next Page → Send Block Data to Backup


  1. After the data has finished sending your drive will be unmounted and it is safe to disconnect.

  1. You can also use this option anytime to add new blockchain data to an already existing backup drive, as the blockchain grows in size over time.

Receive Blockchain Data from Backup Drive:

  1. Connect your backup SSD or HDD to your RoninDojo. Go back to the RoninCLI and select the option to receive data from the backup drive.

         Dojo → Next Page → Receive Block Data from Backup


  1. Please note that your node will not be fully functional until the indexer compaction is complete. This takes about 10hrs after the data Blockchain Data is finished with sync.

Copy Data from Other Node to RoninDojo

Want to copy the blockchain data from an existing bitcoin node to your RoninDojo bitcoin node?

We will show you how to use the rsync command plus a few others so you can avoid redownloading the chain. Advanced users should be able to adapt these commands to meet their needs.

Before starting, you must have a RoninDojo bitcoin node setup and running!


  1. RoninDojo SSH remote login into your RoninCLI. Record the IP address for your RoninDojo bitcoin node and save it for later in this guide.

  1. RoninDojo: Make sure to stop Dojo before progressing, otherwise there can be errors!

  1. Other Node: SSH remote login into your other node, in this example the user has a Mynode which will be called "other node".

  1. Other Node: Make sure to stop bitcoind your other node before progressing, otherwise there can be errors!

  1. Other Node: On your other node, locate the block data directory using the find command.
find / -name blocks

  1. Other Node: For example if you are using Mynode, then you might get an output like this.
/mnt/hdd/mynode/bitcoin/blocks

  1. RoninDojo: Run the following command on your RoninDojo to delete any existing block data just in case.
sudo rm -rf /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/{blocks,chainstate,indexes}

  1. RoninDojo: Verify the backup directory exists, and if it is not found the mkdir command is used to create it.
ls /mnt/usb/backup || sudo mkdir /mnt/usb/backup

  1. RoninDojo: Change the backup directory to be temporarily owned by user ronindojo.
sudo chown ronindojo:ronindojo /mnt/usb/backup

  1. Other Node: Run the rsync command which has been adapted with the proper file paths, username, and IP address of your RoninDojo.
sudo rsync -av /mnt/hdd/mynode/bitcoin/{blocks,chainstate,indexes} ronindojo@192.168.X.X:/mnt/usb/backup

  1. Other Node: The rsync will take a while to run so please be patient until the transfer completes. Once the transfer is complete you can restore your other node to usual operations.

  1. RoninDojo: Once the transfer is complete, run the move command to get the blocks/ chainstate/ indexes/ relocated to the bitcoind data directory.
sudo mv /mnt/usb/backup/{blocks,chainstate,indexes} /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/

  1. RoninDojo: Run the command to change the permissions for blocks/ chainstate/ indexes/ directories.
sudo chown -R 1105:1108 /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/{blocks,chainstate,indexes}

  1. RoninDojo: Run the command to restore ownership of the backup/ directory to the root user.
sudo chown root:root /mnt/usb/backup

  1. RoninDojo: Start your RoninDojo, and check on the logs to make sure everything looks healthy!

WinSCP Copy Data from Windows11 to RoninDojo

Want to download a copy of the blockchain on that speedy Windows gaming computer and transfer to your RoninDojo on the same local network?

We know the blockchain takes a while to download when starting fresh without a backup copy, and want to give power users with high performance computers other options.

Before starting, you must have a RoninDojo bitcoin node setup and running!


  1. Windows11: Download bitcoin core, sync the blockchain, and download WinSCP. The blockchain will take a few hours to sync.

  2. Windows11: Once synchronized, make sure to close bitcoin core before progressing otherwise there can be errors!


  1. Windows11: SSH remote login into your RoninCLI device using the Windows command prompt.

  1. RoninDojo: Make sure to stop RoninDojo before progressing, otherwise there can be errors!

  1. RoninDojo: Verify the backup directory exists, if it is not found an error will appear, and the mkdir command will create it.
ls /mnt/usb/backup || sudo mkdir /mnt/usb/backup

  1. RoninDojo: Change the backup directory to be temporarily owned by username ronindojo.
sudo chown ronindojo:ronindojo /mnt/usb/backup

  1. Windows11: Open WinSCP and type in the hostname of your RoninDojo (local IP address), username (usually ronindojo), and password (same as your SSH password).

  1. Windows11: Go to C:\Users\Username\Appdata\Roaming\Bitcoin in Windows file explorer.

  1. Windows11: In WinSCP, go to /mnt/usb/backup on your RoninDojo device, then copy over the blocks chainstate indexes directories from Windows to the RoninDojo device. Wait a couple hours for the transfer to finish.

  1. Windows11: Once the transfer is finished you can exit WinSCP.

  1. RoninDojo: Run the following command to delete any existing block data just in case.
sudo rm -rf /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/{blocks,chainstate,indexes}

  1. RoninDojo: Run the move command to get the blocks chainstate indexes relocated to the bitcoind data directory.
sudo mv /mnt/usb/backup/{blocks,chainstate,indexes} /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/

  1. RoninDojo: Run the command to change the permissions for blocks chainstate indexes directories.
sudo chown -R 1105:1108 /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/{blocks,chainstate,indexes}

  1. RoninDojo: Check if permissions are set properly.
sudo ls -la /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/|egrep '(blocks|chainstate|indexes)'

You should see something similar to the following if permission are correct:

drwx------ 3 1105 1108   135168 Jul  10 04:20 blocks
drwx------ 2 1105 1108    94208 Jul  10 04:20 chainstate
drwx------ 3 1105 1108     4096 Jul  10 04:20 indexes

  1. RoninDojo: Finally, run the following command to restore ownership of the backup directory to the root user.
sudo chown root:root /mnt/usb/backup

  1. RoninDojo: If everything looks good, go ahead and start your Dojo from the ronin command line menu.

  1. Please note that your node will not be fully functional until the indexer compaction is complete. This takes about 8hrs after the Blockchain Data is finished transfering.

Additional Info

Check out Extras for more inspiration and ideas.

Join the RoninDojo Chatroom and engage the community.