Skip to content

Latest commit

 

History

History
126 lines (89 loc) · 5.55 KB

README.md

File metadata and controls

126 lines (89 loc) · 5.55 KB
Raw

⚡️ 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.

Downloads and walkthrough for the Odroid HC1 / HC2 / XU3 / XU4

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.

  • Burn the image to the SDCard with 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:

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

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

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/