Skip to content

Commit

Permalink
general guide for dietpi
Browse files Browse the repository at this point in the history
  • Loading branch information
@openoms
openoms committed Feb 18, 2019
1 parent cf8cba1 commit 9e8a42d
Show file tree
Hide file tree
Showing 3 changed files with 160 additions and 95 deletions.
5 changes: 5 additions & 0 deletions FAQ.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -506,3 +506,8 @@ You could try to re-index, but that can take some very long time - multiple days
Another option would be to delete the old blockchain and get a new one. See for details the FAQ question: [I have the full blockchain on another computer. How do I copy it to the RaspiBlitz?](FAQ.md#i-have-the-full-blockchain-on-another-computer-how-do-i-copy-it-to-the-raspiblitz). And even if you are not able to delete the data, first rename the undeletable folders and then follow the instructions.

Also make sure to check again on your power supply - it needs to deliver equal or more then 3A and should deliver a stable current. If you think your HDD is degrading - maybe this is a good time to replace it. See for details the FAQ question: [How can I recover my coins from a failing RaspiBlitz?](FAQ.md#how-can-i-recover-my-coins-from-a-failing-raspiblitz)

## Can I flip the screen?

For the default 3.5" LCD you need to edit the /boot/config.txt. Run `sudo nano /boot/config.txt`
look for the line `dtoverlay=tft35a:rotate=270` towards the end. To flip the screen with 180 degrees change the line to `dtoverlay=tft35a:rotate=90` and reboot with `sudo reboot`. Reference: https://github.com/goodtft/LCD-show/issues/34
121 changes: 121 additions & 0 deletions dietpi/Odroid_HC1_HC2.md
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,121 @@

![](pictures/DroidBlitz.jpg)


## Download the fully prebuilt RaspiBlitz-on-DietPi SDcard image for the Odroid HC1 / HC2 / XU3 / XU4

for the Odroid HC1 / HC2 / XU3 / XU4 from this [torrent](https://github.com/openoms/raspiblitz/blob/raspiblitz-dev/dietpi/RaspiBlitz1.0_OdroidHC1_DietPi6.21.1.torrent) or from [mega.nz](https://mega.nz/#F!EVNAAQiB!ZyLHP2dJMRSVjZOTCQMIYA).
(sha256sum RaspiBlitz1.0_OdroidHC1_DietPi6.21.1.img:
96ee8700f52a12fb5b13fab3fffcdcf5d364c6dd16c580d969e421cef2cd7cc2)

Steps to run:
- download the .img file,
- burn to a 16 GB SD with [Etcher](https://www.balena.io/etcher/)
- extend the rootFS partition with a partition manager (disks, Gparted, etc.)
- boot the Odroid with the SDcard and login with ssh [email protected], password: raspiblitz

Using this image you can skip the rest of this guide as it is mostly about how this image was built.

The setup continues with the [RaspiBlitz Setup Process](https://github.com/rootzoll/raspiblitz/blob/master/README.md#setup-process-detailed-documentation)

---
## Setting up the DietPi OS

### Download the updated DietPi image

For the Odroid HC1 / HC2 / XU3 / XU4 a v6.20.6 DietPi image with fail2ban installed is uploaded [here](
https://mega.nz/#!AcdVBAbR!O-W3jP5LUgw7lMY8S9XcBWcKX3IhRNAAFmaYzDXIUC0). (sha256sum DietPi_v6.20.6_OdroidXU4-ARMv7-Stretch.img:
1459b91f66b9db98f3437c31231e44497b7b7dcd9146d2cc41a3da653f9a9215)

Burn 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 the Odroid.

Power up and continue with: [Run the DietPi optimized Raspiblitz SDcard build script](#Run-the-RaspiBlitz-build_sdcard.sh-script)

### Build your own DietPi image:

Watch out this an ardous process.
Updating from a v6.14 DietPi image is causing a bootloop under some circumstances. Will be sorted once the current, >6.2 version is uploaded for the Odroids.

For the Odroid HC1 / HC2 / XU3 / XU4 the start is this image:
https://dietpi.com/downloads/images/DietPi_OdroidXU4-ARMv7-Stretch.7z
Burn it to the SD with [Etcher](https://www.balena.io/etcher/)

Getting started with DietPi: https://dietpi.com/phpbb/viewtopic.php?f=8&t=9#p9

In the desktop terminal on Linux / MacOS or Putty on Windows:

`ssh root@[IP-OF-DIETPI]`
password: `dietpi`

Ok > Cancel > Cancel
automatic apt update & apt upgrade and asks to reboot
![](pictures/dietpi_1st_reboot.png)

`ssh root@[IP-OF-DIETPI]`
after the previous update the ssh keys might change:

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

run (can be copied from the terminal output):
`ssh-keygen -f "/home/[your-linux-username]/.ssh/known_hosts" -R "dietpi.IP"`

`ssh root@[IP-OF-DIETPI]`
yes >
password: `dietpi`

At this point if the DietPi was not updated from 6.14 it does not manage to save settings going forward.
Exit the sotware installer (press Tab to jump to Exit)
![](pictures/dietpi-software_exit.png)

in the bash prompt run:
`dietpi-update`
>Ok > Cancel the recovery point
update > >Opt out of survey > Ok
Reboots

`ssh root@[IP-OF-DIETPI]`
password: `dietpi`

>Ok > Cancel > Cancel
Search `fail2ban` > Space to select > Enter
SSH server > switch from Dropbear to the OpenSSH-server
> Install > Ok
>Opt out of survey > Ok
Reboots again

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"`


## Run the RaspiBlitz build_sdcard.sh script

In the desktop terminal in Linux / MacOS or Putty in Windows:

`ssh root@[IP-OF-DIETPI]`
password: `dietpi`
Should end up here on version v6.20.6 or higher:
![](pictures/bash_prompt.png)

run the build_sdcard.sh script in this format:
`wget https://raw.githubusercontent.com/[GITHUB-USERNAME]/raspiblitz/[BRANCH]/build_sdcard.sh && sudo bash build_sdcard.sh [BRANCH] [GITHUB-USERNAME]`

Be aware of that the fork needs to be called `raspiblitz` for the git download to work.
if you intend to use @openoms`s forked version:

`wget https://raw.githubusercontent.com/openoms/raspiblitz/raspiblitz-dev/build_sdcard.sh && sudo bash build_sdcard.sh raspiblitz-dev openoms`


`ssh admin@[IP-OF-DROIDBLITZ]`
password: raspiblitz

The setup continues with the [RaspiBlitz Setup Process](https://github.com/rootzoll/raspiblitz/blob/master/README.md#setup-process-detailed-documentation)

---
### Examples of copying the blockchain data from a HDD using a powered USB to SATA adapter

![example setup](pictures/HDD_copy_example.jpg)
![](pictures/adapterHDD_HC1.jpg)
129 changes: 34 additions & 95 deletions dietpi/README.md
View file
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# ⚡️ RaspiBlitz on DietPi ⚡️
# ⚡️ RaspiBlitz-on-DietPi ⚡️
# A hardware agnostic platform


Expand All @@ -9,128 +9,67 @@ This guide was tested on:
* 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 specs: [hardware specs](hw_comparison.md).
See the [hardware comparison](hw_comparison.md).


![](pictures/DroidBlitz.jpg)

## Download the fully prebuilt RaspiBlitz on DietPi SDcard image

for the Odroid HC1 / HC2 / XU3 / XU4 from this [torrent](https://github.com/openoms/raspiblitz/blob/raspiblitz-dev/dietpi/RaspiBlitz1.0_OdroidHC1_DietPi6.21.1.torrent) or from [mega.nz](https://mega.nz/#F!EVNAAQiB!ZyLHP2dJMRSVjZOTCQMIYA).
(sha256sum RaspiBlitz1.0_OdroidHC1_DietPi6.21.1.img:
96ee8700f52a12fb5b13fab3fffcdcf5d364c6dd16c580d969e421cef2cd7cc2)

Steps to run:
- download the .img file,
- burn to a 16 GB SD with [Etcher](https://www.balena.io/etcher/)
- extend the rootFS partition with a partition manager (disks, Gparted, etc.)
- boot the Odroid with the SDcard and login with ssh [email protected], password: raspiblitz

Using this image you can skip the rest of this guide as it is mostly about how this image was built.

The setup continues with the [RaspiBlitz Setup Process](https://github.com/rootzoll/raspiblitz/blob/master/README.md#setup-process-detailed-documentation)

### Downloads and walkthrough for the [Odroid HC1 / HC2 / XU3 / XU4](Odroid_HC1_HC2.md)
---
## Setting up the DietPi OS

### Download the updated DietPi image
## General Guide for RaspiBlitz-on-DietPi

For the Odroid HC1 / HC2 / XU3 / XU4 a v6.20.6 DietPi image with fail2ban installed is uploaded [here](
https://mega.nz/#!AcdVBAbR!O-W3jP5LUgw7lMY8S9XcBWcKX3IhRNAAFmaYzDXIUC0). (sha256sum DietPi_v6.20.6_OdroidXU4-ARMv7-Stretch.img:
1459b91f66b9db98f3437c31231e44497b7b7dcd9146d2cc41a3da653f9a9215)
### Setting up the DietPi OS

Burn 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.
* 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).

Insert the SDcard into the Odroid.
* 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.

Power up and continue with: [Run the DietPi optimized Raspiblitz SDcard build script](#Run-the-RaspiBlitz-build_sdcard.sh-script)
* Insert the SDcard into your SBC.

### Build your own DietPi image:
* 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.

Watch out this an ardous process.
Updating from a v6.14 DietPi image is causing a bootloop under some circumstances. Will be sorted once the current, >6.2 version is uploaded for the Odroids.
* Power up and continue with: [Run the DietPi optimized Raspiblitz SDcard build script](#Run-the-RaspiBlitz-build_sdcard.sh-script)

For the Odroid HC1 / HC2 / XU3 / XU4 the start is this image:
https://dietpi.com/downloads/images/DietPi_OdroidXU4-ARMv7-Stretch.7z
Burn it to the SD with [Etcher](https://www.balena.io/etcher/)

Getting started with DietPi: https://dietpi.com/phpbb/viewtopic.php?f=8&t=9#p9

In the desktop terminal on Linux / MacOS or Putty on Windows:


* In the desktop terminal on Linux / MacOS or Putty on Windows:
`ssh root@[IP-OF-DIETPI]`
password: `dietpi`
Getting started with DietPi: https://dietpi.com/phpbb/viewtopic.php?f=8&t=9#p9

Ok > Cancel > Cancel
automatic apt update & apt upgrade and asks to reboot
![](pictures/dietpi_1st_reboot.png)

`ssh root@[IP-OF-DIETPI]`
after the previous update the ssh keys might change:

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

run (can be copied from the terminal output):
`ssh-keygen -f "/home/[your-linux-username]/.ssh/known_hosts" -R "dietpi.IP"`

`ssh root@[IP-OF-DIETPI]`
yes >
password: `dietpi`

At this point if the DietPi was not updated from 6.14 it does not manage to save settings going forward.
Exit the sotware installer (press Tab to jump to Exit)
![](pictures/dietpi-software_exit.png)

in the bash prompt run:
`dietpi-update`
>Ok > Cancel the recovery point
update > >Opt out of survey > Ok
Reboots

`ssh root@[IP-OF-DIETPI]`
password: `dietpi`

>Ok > Cancel > Cancel
Search `fail2ban` > Space to select > Enter
SSH server > switch from Dropbear to the OpenSSH-server
> Install > Ok
>Opt out of survey > Ok
Reboots again
* You might be asked about updating DietPi. This might not be straightforward if starting froma 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"`


## Run the RaspiBlitz build_sdcard.sh script

In the desktop terminal in Linux / MacOS or Putty in Windows:

* After every reboot log back in:
`ssh root@[IP-OF-DIETPI]`
password: `dietpi`
Should end up here on version v6.20.6 or higher:
password: `dietpi`

* Should end up here on version v6.20.6 or higher:
![](pictures/bash_prompt.png)

run the build_sdcard.sh script in this format:
`wget https://raw.githubusercontent.com/[GITHUB-USERNAME]/raspiblitz/[BRANCH]/build_sdcard.sh && sudo bash build_sdcard.sh [BRANCH] [GITHUB-USERNAME]`

Be aware of that the fork needs to be called `raspiblitz` for the git download to work.
if you intend to use @openoms`s forked version:
### Run the RaspiBlitz build_sdcard.sh script

`wget https://raw.githubusercontent.com/openoms/raspiblitz/raspiblitz-dev/build_sdcard.sh && sudo bash build_sdcard.sh raspiblitz-dev openoms`
* Format of the command to build the SDcard:
`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 ceonnection and the processing power of the SBC.

* Restart when done and log back in now as `admin`:
`ssh admin@[IP-OF-DROIDBLITZ]`
password: raspiblitz
password: `raspiblitz`

The setup continues with the [RaspiBlitz Setup Process](https://github.com/rootzoll/raspiblitz/blob/master/README.md#setup-process-detailed-documentation)
* From here he setup continues with the [RaspiBlitz Setup Process](https://github.com/rootzoll/raspiblitz/blob/master/README.md#setup-process-detailed-documentation)

---
### Examples of copying the blockchain data from a HDD using a powered USB to SATA adapter

![example setup](pictures/HDD_copy_example.jpg)
![](pictures/adapterHDD_HC1.jpg)

---
### Useful commands for debugging:
Expand All @@ -144,7 +83,7 @@ To test a new configuration run XXcleanHDD.sh and strictly restart
`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
`./home/admin/XXdebugLogs.sh` - debug log collection on the RaspiBlitz

---

Expand Down

0 comments on commit 9e8a42d

Please sign in to comment.