Manual Install

This section covers everything you need to know about installing a RoninDojo Bitcoin node using the manual deployment method.

Note

The manual deployment is intended for advanced users that want to use Debian (x86) or Armbian (ARM) operating systems instead of the customized RoninOS. If you want the easiest path, use the Plug and Play Install instead.

Requirements

Make sure you have the correct hardware from the Compatible Hardware List.

How to Flash

Debian OS

1. Download Balena Etcher.

2. Insert the USB Flash Drive into your PC, open Balena Etcher, select the Debian image, select your USB Drive, and finally press Flash!

Flash Armbian OS

1. Download the Armbian Imager.

2. Insert the MicroSD Card into your board, open Armbian Imager and select your board, then select your microSD card, and finally press Flash!

How To Boot

Debian OS

1. Insert the USB Flash Drive into your RoninDojo device.

2. Plug in the keyboard, ethernet cable, and power on the device.

3. Boot the Desktop x86 device and press the Delete or F12 key to get to the boot menu. Choose to boot the USB Flash Drive with Debian OS on it.

4. Use SSH to remotely log in to your device, then copy/paste following commands to start the initial setup.

   Initial Setup

   sudo apt-get update && sudo apt-get install git tor
   git config --global --unset http.proxy
   config --global http.proxy socks5h://127.0.0.1:9050
   git clone http://2l2o5umijiwxjioxwpsvwxe6pr75tj7r5rggnl5ze256guwvtee3kpqd.onion/Ronin/monorepo.git
   cd monorepo/ronindojo && ./start.sh

5. Once initial setup is complete, you can start the RoninDojo manual install.

   Start Manual Install

   cd .ronindojo/ronindojo && ./start.sh

Armbian OS

1. Insert the MicroSD Card into your RoninDojo device.

2. Plug in the ethernet cable, and power on the device. Some devices may turn on automatically once the power cable is inserted.

3. Use SSH to remotely log in to your device, then copy/paste the following commands to start the initial setup.

   Initial Setup

   sudo apt-get update && sudo apt-get install git tor
   git config --global --unset http.proxy
   config --global http.proxy socks5h://127.0.0.1:9050
   git clone http://2l2o5umijiwxjioxwpsvwxe6pr75tj7r5rggnl5ze256guwvtee3kpqd.onion/Ronin/monorepo.git
   cd monorepo/ronindojo && ./start.sh

4. Once initial setup is complete, you can start the RoninDojo manual install.

   Start Manual Install

   cd .ronindojo/ronindojo && ./start.sh

How To Login

1. Open a web browser on another device, make sure any VPN is disabled, and enter the following.

   Login Using ronindojo.local

   http://ronindojo.local

   Login Using IP Address

   http://ronin@192.168.X.X

2. Set your user password, which will be used to log into RoninUI.

   • Use a strong alphanumeric password.
   • Do not use special characters such as @, #, &, ?.

3. Wait for the initialization to complete. After initialization, you can access your RoninUI dashboard.

4. Your node will not be functional until the blockchain and indexer sync has finished.

Caution

Having issues? Try restarting from flashing step 1 or contact support.

Next Steps

RoninUI GuideLearn how to use your node's web dashboard.

Ashigaru Wallet GuideLearn to connect the privacy focused Ashigaru Wallet to your node.

SSH Access

Prefer to use command line menus? After you create a password, you can SSH remote log in using the ronin username. See the RoninCLI Section for more info.

SSH Using ronindojo.local

ssh ronin@ronindojo.local

SSH Using IP Address

ssh ronin@192.168.X.X