After setting up your RoninDojo, simply type ronin
into the terminal at any time to enter the menu. Most of the troubleshooting is done manually or from within the RoninDojo command line menu.
This section is for those manually installing via commandline. These issues are not typical for RoninDojo users as this is all usually automated via scripts, but very common with manual installs.
dojo.sh install
the MySQL configs should not be modified. This can result in permission issues & the only solution(if you can't remember original password) is to completely remove and reinstall Dojo..config
files for Dojo to know which one needs to be modified to make changes..conf
is the config file your Dojo is working off of.conf.tpl
is the temporary config file that's in Dojo that gets used to setup the initial install..conf.save
is the config that is stored after an update to Dojo has been done to make a copy of the previous settings, just in case!bitcoind
you can run into network issues. Usual causes are:bitcoind
bitcoin.conf
or in docker-nodejs.conf
)bitcoin.conf
Checking the error logs is the first step in troubleshooting your Dojo! You can view errors anytime by going to the the Dojo Menu. Here is an example.
Dojo
→ Logs
→ Error Logs
→ Indexer
Note: Within the RoninDojo Menu, some error logs will have no output if there are not any errors.
You can also pull them via command line. Check here to see how it can be done via CL.
Please don't hesitate to reach out to the community with your issues!
If your Dojo 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.
The Dojo Logs and can be found from within the Dojo Menu. Press Ctrl+C
to exit from viewing logs anytime. Here is an example of the menu choices to view all logs.
Dojo
→ Logs
→ All Logs
If you are new to the command line, you might be thinking "What am I looking at or looking for?"
Below are examples of logs showing everything is running ok.
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.
This connection closed normally without authentication
can be disregard as this is normal.
If you chose to install the Indexer, then this is what you should expect from the logs once the initial block download is complete.
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!
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.
The Whirlpool command-line interface logs give useful information about status, connections, mixes, and more.
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 /admin
to the end off the .onion address
Then enter your Admin Key
to gain access
A Start Dojo command can be issued from the Dojo Menu.
Dojo
→ Start
Once Dojo is set up and installed, it will auto-start when your device is powered on.
A Stop Dojo command can be issued from the Dojo 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 RoninDojo menu to turn off or restart your device.
A Restart Dojo command can be issued from the Dojo Menu.
Dojo
→ Restart
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 RoninDojo menu to turn off or restart your device.
A Dojo Uninstall can be done from the Dojo Menu.
System
→ Next Page
→ Uninstall RoninDojo
If you uninstall, then all settings and data from your RoninDojo will be erased, unless you choose to salvage data during the uninstall. In order to reinstall, you will need to go to the installations menu and only select to install RoninDojo.
System Setup & Install
→ [*] Install RoninDojo
→ OK