¶ Using RoninCLI Menus
After setting up your RoninDojo bitcoin node, simply type ronin into the terminal at any time to enter the menu. Most of the troubleshooting is done manually or from within the RoninCLI command line menu.
¶ Dojo Logs
Checking the logs for the Dojo software stack is the first step in troubleshooting your RoninDojo bitcoin node! You can view logs by using the RoninCLI menus. Here is an example.
Dojo → Logs → Tor
Note: Within the RoninCLI Menu, some error logs will have no output if there are not any errors.
You can also pull them by using specific commands in the terminal.
Please don't hesitate to reach out to the community with your issues!
¶ Dojo Installation Issues
If your Dojo software stack install goes wrong you may see a false positive "Dojo is already started!" when trying to start. If so, please seek support in RoninDojo Chatroom.
¶ Dojo Log Examples
If you are new to the RoninCLI or command line in general, you might be thinking "What am I looking at or looking for?"
Below are examples of the Dojo software stack logs. Please take note what these logs looks like as this indicates a healthy RoninDojo bitcoin node.
¶ Bitcoind
These logs will show the blocks mined.
You will know the initial block download is complete once you see progress=1.0.
It will also show Tor connections to peers, which rotate so you can disregard failed: general failure & failed: connection refused.
The warning= 'xx of last 100 blocks have unexpected version means the miner that mined the block is running a different version of core than yourself, you can disregard.
¶ MariaDB
This connection closed normally without authentication can be disregard as this is normal.
¶ Indexer
If you chose to install the Indexer, then this is what you should expect from the logs once the initial block download finishes, and the indexer compaction is complete.
¶ Node.js
The Node.js logs will display the pubkeys that are being tracked via multiaddr & unspent, it will also display when a new block is mined. In this screenshot the infamous pubkeys displayed are those of your HD public addresses, and you should never share a screenshot like this with anyone. Anyone who had these so called pubkeys would be able to view balances. Of course your private keys are safely stored on Samourai Wallet, and thusly whatever bitcoin balance could not be stolen. It is still important to be aware of this so that you do not "doxx" yourself.
If someone has access to pubkeys they can view your entire wallet balance & transactions!
¶ Tor
Have tried resolving or connecting to address '[scrubbed]' at 3 different places. Giving up. is totally normal and just means tor is looking for a connection.
¶ Whirlpool
The Whirlpool command-line interface logs give useful information about status, connections, mixes, and more.
¶ Dojo Maintenance Tool
The Tor (browser) address for the Dojo Maintenance Tool can be obtained at anytime, by selecting the following.
Credentials → Dojo
This will display your Dojo Maintenance Tool onion address that you can paste in a Tor browser.
If you wish to access the Maintenance Tool, copy and paste the v3 onion address into a Tor Browser:
-
add
/adminto the end off the .onion address -
Then enter your
Admin Keyto gain access
¶ Start Dojo
A Start Dojo command can be issued from the RoninCLI menu.
Dojo → Start
Once all the Dojo containers are set up, it will auto-start when your device is powered on.
¶ Stop Dojo
A Stop Dojo command can be issued from the RoninCLI menu.
Dojo → Stop
Make sure Dojo is stopped before your device turns off or your data could be corrupted. Dojo will be stopped first if you use the RoninCLI menu to turn off or restart your device.
¶ Restart Dojo
A Restart Dojo command can be issued from the RoninCLI menu.
Dojo → Restart
¶ Uninstall RoninDojo
A Dojo Uninstall can be done from the RoninCLI menu.
System → Next Page → Uninstall RoninDojo
If you uninstall, then all settings and data from your RoninDojo bitcoin node will be salvaged for the next install. In order to reinstall, you will need to go to the installations RoninCLI menu, and only select to install RoninDojo.
System Setup & Install → [*] Install RoninDojo → OK