RoninCLI Guide

Introduction

Accessing the Command Line Interface known as RoninCLI allows you to carry out more in-depth maintenance, access advanced features, tweak configuration files, and more.

The following steps will teach you how to SSH remote login to the RoninCLI and begin navigating the menus.

How to login to RoninCLI locally

1. Open a Terminal on your machine, and use one of the following methods to SSH remote login.

   Example Using ronindojo.local

   ssh ronin@ronindojo.local

   Example Using IP Address

   ssh ronin@192.168.X.X

2. If this is the first time SSHing into your node, you will be prompted with a message similar to:

   The authenticity of host ‘192.168.7.100 (192.168.7.100)’ can’t be established. ECDSA key fingerprint is SHA256:xxxxxxxxxxxxxxxx. Are you sure you want to continue connecting (yes/no/[fingerprint])?

3. Type yes and enter your password.

4. You will be greeted with the RoninCLI graphical interface.

Tip

Need help finding your RoninDojo’s IP address? See the section below.

How to get your IP Address

1. Sign in to your RoninUI, and navigate to System.

2. Copy the IPv4 address to your clipboard.

How to navigate RoninCLI

1. Use your arrow keys to navigate the RoninCLI menus, and press ENTER to navigate into sub-menus.

2. When viewing logs, you can exit back to the RoninCLI using Ctrl + C.

3. If you exit the menus, type ronin and press ENTER to reopen them at any time.

How to manage apps using RoninCLI

1. You can manage your third party applications from the RoninCLI menu by selecting:

   Applications → Manage Applications

2. Using the mouse or arrow keys, navigate to each of the menu items and select each one using the spacebar or a mouse click. When you press OK, the process will start and should take a few minutes. You may press the Cancel button at any time to abort and return to previous menus.

3. In this example the user has chosen to install Mempool Space Visualizer:

   [*] Install Mempool Space Visualizer

4. You can manage multiple applications at once by using the spacebar or a mouse click. A [*] asterisk appears when an option is selected, and [ ] means it has not been selected. After pressing OK, your changes will be finalized.

How to update

You can get updates for your RoninDojo bitcoin node using the RoninCLI menu:

System → Software Updates → Update RoninDojo

How to fix host identification change

If you have the error Remote Host Identification Has Changed on your terminal, then you can resolve it by entering the following command.

ssh-keygen -R [NodeIpAddress]

Here is an example.

ssh-keygen -R 192.168.100.3

The most common reasons for this message are:

1. Reinstallation of Ronin OS: If the operating system is reinstalled, it generates a new SSH key. As a result, when you try to SSH into the Tanto, the SSH client detects different host identification information.

2. IP address change: If the IP address of the Tanto is changed, the SSH client may show the “REMOTE HOST IDENTIFICATION HAS CHANGED” message. Your router may occasionally issue a new IP address to devices on the network, depending on its DHCP lease time.

How to access Dojo Maintenance Tool

The Tor (browser) address for the Dojo Maintenance Tool can be obtained at any time 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:

1. Add /admin to the end of the .onion address.

2. Then enter your Admin Key to gain access.