Some advanced users may want to do a custom build. This is possible, but there could be problems that may be difficult to solve for less experienced users.
WARNING - Custom build at your own risk! Many hardware setups can cause problems.
Requirements for Bitcoin Node Custom Build:
Single-board Computers we have seen used for custom building:
Finally, one more reminder that it is mainly up to the community to help one another with custom builds. We cannot be held liable for third party hardware issues.
⚠ AVOID SSD ENCLOSURES AND ADAPTER CABLES! - Use SATA Drives + Enclosures at your own risk! ⚠
IF YOU ARE USING SOMETHING OTHER THAN THE RECOMMENDED HARDWARE, YOU COULD RUN INTO ISSUES SUCH AS I/O ERRORS OR PROBLEMS WITH DRIVE ENCLOSURE POWER WHICH CAUSE SSD FAILURE.
If your device is slow and will take a very long time to download and sync the blockchain and indexer, then consider trying to use a backup SSD or try to copy data from another node to your RoninDojo. These methods will typically be much faster than waiting for the initial blockchain download.
Flash!
Raspberry Pi Imager is the quick and easy way to install Raspberry Pi OS and other operating systems to a microSD card, ready to use with your Raspberry Pi.
- Windows users: Double click the imager_1.7.x.exe
in your Downloads folder and follow the instructions on screen. Launch the application when installation has completed.
- MacOS users: Double click the imager_1.7.x.dmg
in your Downloads folder and follow the instuctions on screen. Launch the application when installation has completed.
- Ubuntu/PopOS/Debian users: Open Terminal and then do the following:
cd Downloads
and Press ENTER
sudo apt install ./imager
then Press TAB key and then Press ENTER
type y
and Press ENTER to install all dependencies
Click show applications icon
select Imager with the app icon of a Raspberry to launch the application.
With the Raspberry Pi Imager Application launched you should be looking at a screen that looks like this:
Before Proceeding: You should ensure your microSD that you removed from Step 2 is now in a suitable adapter and it is connected to your computer/laptop.
The below is an essential step and must be carried out prior to writing the microSD card. Please take care with this next step otherwise you may experience issues and will be required to re-flash the microSD.
Click on the Cog icon to load the Advanced Settings Options
RoninDojo
pi
(This user will be removed later)Once you have completed the above steps check that your options look like this:
If your settings match the screenshot above Click SAVE
Click WRITE to write the microSD
A pop up will appear asking you to confirm you wish to delete all existing data on the selected storage device. Use this opportunity to double check that you are erasing the correct device i.e. The Generic MassStorage 32GB microSD card.
Notice: if you are struggling to find the IP address, ensure your node is turned on! You can also try using Angry IP Scanner or check your router control panel.
ssh-keygen -R [IP]
For example ssh-keygen -R 192.168.1.140
ssh pi@[IP]
For example ssh pi@192.168.1.140
yes
and Press ENTER when asked Are you sure you want to continue connecting?sudo apt update && sudo apt upgrade -y
sudo apt install git dialog tor npm -y
sudo echo "denyinterfaces veth*" >> /etc/dhcpcd.conf
sudo git config --global http.proxy socks5h://127.0.0.1:9050
sudo git clone --branch master http://2l2o5umijiwxjioxwpsvwxe6pr75tj7r5rggnl5ze256guwvtee3kpqd.onion/Ronin/RoninOS.git /opt/RoninOS
cd /opt/RoninOS/scripts/install && sudo ./customize-image.sh
Be sure to wait the full 10 minutes for the preparation setup to complete in terminal before continuing to Step 9 otherwise you may experience issues and will be required to re-flash the microSD.
We are almost there now. We will do a couple more command line instructions to install RoninOS
sudo systemctl start ronin-setup
tail -f /home/ronindojo/.logs/setup.logs
All good things come to those who wait, we are almost there be sure to grab a cup of coffee and wait a further 30 minutes before proceeding to the next step.
alternatively
Follow the on-screen instructions:
***
All RoninDojo feature installations complete!
***
active
Removed /etc/systemd/system/multi-user.target.wants/ronin-setup.service
Open a new clean Terminal/Powershell
ssh ronindojo@[IP]
For example ssh ronindojo@192.168.1.140
enter the password for RoninDojo that you set in Step 11
You may be asked to re-enter the password a second time, go ahead and do so
At the RoninCLI menu choose Exit RoninDojo
type sudo deluser --remove-home pi
and Press ENTER
type sudo reboot now
ENTER
You did it! Enjoy RoninDojo 2.0.0
If you have blockcahin data and indexer data it will be salvaged. You just need to wait for them both to catch up to the latest blockheight.
Before continuing, wait for the following to be displayed within your RoninUI:
Notice: If Dojo does not reach 100% Synchronized, restart Dojo from within your RoninUI by going: Dashboard
> Dojo
> Manage
> Restart
, then wait for Dojo to reach 100%.