# ⚡️ RaspiBlitz-on-DietPi ⚡️ # A hardware agnostic platform This guide was tested on: * Odroid HC1 * Odroid HC2 (the same board except it accommodates a 3.5" 12V HDD) * Raspberry Pi 3 B Plus - no LCD support so far * hoping to extend this list with more compatible boards especially the ROCK64 See the [hardware comparison](hw_comparison.md). --- ### Downloads and walkthrough for the [Odroid HC1 / HC2 / XU3 / XU4](Odroid_HC1_HC2.md) --- ## General guide for the RaspiBlitz-on-DietPi ### Setting up the DietPi OS Getting started with DietPi: https://dietpi.com/phpbb/viewtopic.php?f=8&t=9#p9 * Start with an ARM based Single Board Computer listed on DietPi.com. At least 1GB RAM is recommended. Look for the SD card image for the specific SBC in the [download section](https://dietpi.com/#download). * Burn the image to the SDCard with [Etcher](https://www.balena.io/etcher/) and extend the rootfs partition to the size of your card with a partition manager. * Insert the SDcard into your SBC. * Connect the HDD with a powered suitably powered adapter. A USB 2.0 port will not be able to power an HDD so you will need extra cable If you are connecting the HDD to a USB 3.0 port and have an at least 2A power supply, you might be able to run without an extra cable. * Power up and log in with the desktop terminal on Linux / MacOS or Putty on Windows: `ssh root@[IP-OF-DIETPI]` password: `dietpi` * You might be asked about updating DietPi. This is not a straightforward process if starting from a version <6.20. Try to update, it is best to build on the latest version. * In the DietPi software menu install `fail2ban` and make `OpenSSH server` the default SSH server. Changing the SSH server will change the SSH keys again. To clear: `ssh-keygen -f "/home/[your-linux-username]/.ssh/known_hosts" -R "dietpi.IP"` * After every reboot log back in: `ssh root@[IP-OF-DIETPI]` password: `dietpi` * Should end up here on version v6.20.6 or higher: ![](pictures/bash_prompt.png) ### Run the RaspiBlitz build_sdcard.sh script * Use this format to build the SDcard with the Raspiblitz script: `wget https://raw.githubusercontent.com/[GITHUB-USERNAME]/raspiblitz/[BRANCH]/build_sdcard.sh && sudo bash build_sdcard.sh [BRANCH] [GITHUB-USERNAME]` If you are working from a forked repo be aware of that the fork needs to be called `raspiblitz` for the git downloads to work. * Run the forked version of @openoms: `wget https://raw.githubusercontent.com/openoms/raspiblitz/raspiblitz-dev/build_sdcard.sh && sudo bash build_sdcard.sh raspiblitz-dev openoms` This will take a couple minutes depending on your internet connection and the processing power of the SBC. * Restart when done and log back in now as `admin`: `ssh admin@[IP-OF-DROIDBLITZ]` password: `raspiblitz` * From here he setup continues with the [RaspiBlitz Setup Process](https://github.com/rootzoll/raspiblitz/blob/master/README.md#setup-process-detailed-documentation) --- ### Useful commands for debugging: To test a new configuration run XXcleanHDD.sh and strictly restart (this makes _bootstrap.sh and 00mainMenu.sh run in the right order) `tail -n1000 -f /var/tmp/dietpi/logs/dietpi-automation_custom_script.log` follow startup setup script log `lsblk` see the partitions `tail -n1000 -f raspiblitz.log` - debug logs of bootstrap.sh `sudo tail -f /mnt/hdd/bitcoin/debug.log` - continuous monitoring `sudo tail -n100 /mnt/hdd/bitcoin/debug.log` - shows the last 100 lines `sudo systemctl status lnd` `sudo journalctl -f -u lnd` `./home/admin/XXdebugLogs.sh` - debug log collection on the RaspiBlitz --- ## Excerpts from the default [dietpi.txt](https://github.com/Fourdee/DietPi/blob/master/dietpi.txt) to be used for a fully automatic SDcard building process. ### Automate installation with the dietpi.txt Need to copy to SDcard /boot/dietpi.txt after burning the image with Etcher. IMPORTANT: - Modifications to /boot/dietpi.txt will not be preserved on reboot. - Please ensure you edit from the DietPi-RAMdisk location: /DietPi/dietpi.txt NB: This is intended for advanced users, unless you know what you are doing, do not edit this file. ease use the DietPi programs instead. NB: Do not remove uncommented lines, as the items are scraped by DietPi programs, on demand. DietPi-Automation settings, applied on the 1st boot of DietPi, ONCE Sample: https://github.com/Fourdee/DietPi/blob/master/dietpi.txt ### DietPi-Software to automatically install. Requires `AUTO_SETUP_AUTOMATED=1 ` For a list of software index's (ID's), run '/DietPi/dietpi/dietpi-software list' No limit on number entries, add as many as you need and uncomment the line. DietPi will automatically install all pre-reqs (eg: ALSA/XSERVER for desktops etc) >install fail2ban AUTO_SETUP_INSTALL_SOFTWARE_ID=73 install OpenSSH Client AUTO_SETUP_INSTALL_SOFTWARE_ID=0 install OpenSSH Server AUTO_SETUP_INSTALL_SOFTWARE_ID=105 ### Custom Script (post-networking and post-DietPi install) Runs after DietPi installation is completed Allows you to automatically execute a custom script at the end of DietPi installation. Option 1 = Copy your script to /boot/Automation_Custom_Script.sh and it will be executed automatically. Option 2 = Host your script online, then use AUTO_SETUP_CUSTOM_SCRIPT_EXEC=http://myweb.com/myscript.sh, it will be downloaded and executed automatically. | 0=disabled NB: Executed script log /var/tmp/dietpi/logs/dietpi-automation_custom_script.log ### Guide to clone your SD-cards in Windows, MacOS and Linux and shrink the image in Linux: https://beebom.com/how-clone-raspberry-pi-sd-card-windows-linux-macos/