mirror of
https://github.com/rootzoll/raspiblitz.git
synced 2025-02-25 07:07:46 +01:00
132 lines
No EOL
5.7 KiB
Markdown
132 lines
No EOL
5.7 KiB
Markdown
# ⚡️ RaspiBlitz-on-DietPi ⚡️
|
|
# A hardware agnostic platform
|
|
|
|
|
|
This guide was tested on:
|
|
|
|
* Odroid HC1
|
|
* Odroid HC2 (the same board with a 3.5" 12V HDD)
|
|
* Odroid XU4 (with HDMI screen)
|
|
* Raspberry Pi 3 B + (no support for the default GPIO LCD so far, but the HDMI works)
|
|
|
|
See the [hardware comparison](hw_comparison.md).
|
|
|
|
The screen tested: https://www.aliexpress.com/item/3-5-inch-LCD-HDMI-USB-Touch-Screen-Real-HD-1920x1080-LCD-Display-Py-for-Raspberri/32818537950.html
|
|
|
|
---
|
|
|
|
### 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/).
|
|
|
|
* 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/DietPi/build_sdcard.sh && sudo bash build_sdcard.sh DietPi 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 [customized dietpi.txt](/dietpi/boot/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 be installed automatically
|
|
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
|
|
|
|
#### SSH Server Selection:
|
|
>0=none
|
|
-1=dropbear
|
|
-2=opensshserver
|
|
AUTO_SETUP_SSH_SERVER_INDEX=-2
|
|
|
|
---
|
|
## 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
|
|
|
|
Find the Automation_Custom_Script.sh loaded with the build_sdcard.sh [here](/dietpi/boot/Automation_Custom_Script.sh)
|
|
|
|
---
|
|
## 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/ |