Manual Install

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

Note

The manual install is intended for advanced users that want to use Armbian or Debian instead of RoninOS. You are expected to be able to manage your own Linux OS. 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 ArmbianOS

1. Download the Armbian Imager.

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

Get Started

1. Insert the micro SD card into your RoninDojo device. Plug in the ethernet cable, power cable, and power on the device. Some devices may turn on automatically once the power cable is inserted.

2. Use SSH to remotely log in to your device, then enter 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
   git config --global http.proxy socks5h://127.0.0.1:9050
   git clone http://2l2o5umijiwxjioxwpsvwxe6pr75tj7r5rggnl5ze256guwvtee3kpqd.onion/Ronin/monorepo.git
   cd monorepo/ronindojo && ./start.sh

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

   Start Manual Install

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

4. Open a web browser, 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

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

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

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

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

Caution

Avoid restarting during initial setup, as this can cause problems!

Having issues? Start again with Flash Operating System section above 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