Skip to content

Latest commit

 

History

History
289 lines (229 loc) · 8.71 KB

README.md

File metadata and controls

289 lines (229 loc) · 8.71 KB
Raw

AlpineOS-Cardano-RPi

Why use AlpineOS on the Raspberry Pi? Here are some reasons:

  1. Very low memory consumption (~50MB utilised during idle vs ~350MB for Ubuntu 20.04).

  2. Lower CPU overhead (27 tasks/ 31 threads active for Alpine vs 57 tasks / 111 threads for Ubuntu when cardano-node is running).

  3. Cooler Pi 😎 (Literally, CPU runs cooler because of the lower CPU overhead).

  4. And finally, why not? If you're gonna use static binaries, might as well take advantage of AlpineOS 😜.

If you have previously used this guide and intend to update the scripts. Follow these steps. Then follow the rest of the steps outlined in this guide accordingly 🙂.

  1. Update the git local repo.
cd ~/alpine-rpi-os

git fetch --recurse-submodules --tags --all
  1. Identify the latest tag.
git tag
  1. Replace <tag> in this step with the latest tag such as v1.7.0.
git checkout tags/<tag>

Upgrading to Alpine v3.16 from Alpine v3.15:

  1. Update your current version of AlpineOS.
sudo apk update

sudo apk upgrade
  1. Edit the repository to reflect Alpine v3.17.
sudo sed -i '[email protected]@v3.17@g' /etc/apk/repositories
  1. Update the package list.
sudo apk update
  1. Upgrading packages to v3.17
sudo apk add --upgrade apk-tools

sudo apk upgrade --available

sudo sync

sudo reboot now
  1. Now you should have AlpineOS upgraded to v3.17 🍷.
cat /etc/alpine-release
  1. To troubleshoot the upgrade, refer to the link: https://wiki.alpinelinux.org/wiki/Upgrading_Alpine

Initial Setup for AlpineOS on Raspberry Pi 4B 8GB:

  1. Download the AlpineOS for RPi 4 aarch64 here.

  2. Decompress the .tar.gz file and copy it's contents into an SSD/SD card.

  3. Plug in a keyboard and monitor.

  4. Login with username 'root'.

  5. Run the command setup-alpine and follow the instructions.

  6. At the last step of setup-alpine, you will be prompted to choose the system disk. In case you have missed it, run the command setup-disk and create the partition for sys. You may have to retry and erase the entire disk.

  7. Reboot.

  8. Add a new user called cardano via the command adduser cardano and its password as instructed.

  9. Run the following commands to grant the new user full root privileges.

apk add sudo
echo '%wheel ALL=(ALL) ALL' > /etc/sudoers.d/wheel
addgroup cardano wheel
addgroup cardano sys
addgroup cardano adm
addgroup cardano root
addgroup cardano bin
addgroup cardano daemon
addgroup cardano disk
addgroup cardano floppy
addgroup cardano dialout
addgroup cardano tape
addgroup cardano video

  1. Either exit root via the command exit or reboot and login to cardano. You may continue the next steps via SSH for easy copy and paste 😁.

  2. Install bash to ensure bash script compatibility.

    sudo apk add bash

  3. Also install git, nano and wget, we will need it later.

    sudo apk add git nano wget

  4. [Optional] By default, AlpineOS uses the powersave governor which sets CPU frequency at the lowest. To use the ondemand governor which scales CPU frequency according to system load, cpufreq.start is included in this repo which should be added to /etc/local.d/. You may run the following commands to do this for you.

    cd ~

    git clone https://github.com/armada-alliance/alpine-rpi-os

    cd alpine-rpi-os

    git tag

    Replace <tag> with the latest tag in the next command such as v1.7.0.

    git checkout tags/<tag>

    sudo cp alpine-rpi-os/alpine_cnode_scripts_and_services/etc/local.d/cpufreq.start /etc/local.d/

    sudo chmod +x /etc/local.d/cpufreq.start

    sudo rc-update add local default

  5. [Optional] To alleviate RAM limitation on RPi, ZRAM is recommended to enable RAM compression. Use the following steps to install zram-init and install the scripts. The scripts provided will enable a 50% boost in useable RAM capacity. This step assumes you have followed step 13.

    sudo apk add zram-init

    sudo cp alpine-rpi-os/alpine_cnode_scripts_and_services/etc/local.d/zram.* /etc/local.d/

    sudo chmod +x /etc/local.d/zram.*

  6. Reboot the system.

Installing/Upgrading the 'cardano-node' and 'cardano-cli' static binaries (AlpineOS uses static binaries almost exclusively so avoid non-static builds)

You can obtain the static binaries for version 1.35.4 thanks to Moritz Angermann, the SPO of ZW3RK. You can follow the following commands to install the binaries into the correct folder:

  1. Download the binaries.

    wget -O ~/aarch64-unknown-linux-musl-cardano-node-1.35.4.zip https://github.com/armada-alliance/cardano-node-binaries/blob/main/static-binaries/1_35_4.zip?raw=true

  2. Unzip and install the binaries via the commands.

    unzip -d ~/ aarch64-unknown-linux-musl-cardano-node-1.35.4.zip

sudo mv ~/cardano-node/* /usr/local/bin/

rm -r ~/cardano-node

If you have decided to use AlpineOS for your Cardano stake pool operations, you may find this collection of script and services useful.

To install the scripts and services correctly:

  1. Clone this repo to obtain the neccessary folder and scripts to quickly start your cardano node. You may skip this step if you have already clonned this repo from step 13 when setting up AlpineOS.

    cd ~

    git clone https://github.com/armada-alliance/alpine-rpi-os

    git tag

    Replace <tag> with the latest tag in the next command.

    git checkout tags/<tag>

  2. Run the following commands to then install the cnode folder, scripts and services into the correct folders. The cnode folder contains everything a cardano-node needs to start as a functional relay node.

    cd ~

    cp -r alpine-rpi-os/alpine_cnode_scripts_and_services/home/cardano/* ~/

    sudo cp alpine-rpi-os/alpine_cnode_scripts_and_services/etc/init.d/* /etc/init.d/

    chmod +x ~/start_stop_cnode_service.sh ~/cnode/autorestart_cnode.sh

    sudo chmod +x /etc/init.d/cardano-node /etc/init.d/prometheus /etc/init.d/node-exporter

  3. For faster syncing, consider this optional command for downloading the latest db folder hosted by one of our Alliance members.

    wget -r -np -nH -R "index.html*" -e robots=off https://db.adamantium.online/db/ -P ~/cnode

  4. Follow the guide written in README.txt contained in the $HOME directory after installing cnode, scripts and services.

    more ~/README.txt

If you plan on using prometheus and node exporter, do the following:

  1. Download prometheus and node-exporter into the home directory.

    wget -O ~/prometheus.tar.gz https://github.com/prometheus/prometheus/releases/download/v2.36.2/prometheus-2.36.2.linux-arm64.tar.gz

    wget -O ~/node_exporter.tar.gz https://github.com/prometheus/node_exporter/releases/download/v1.3.1/node_exporter-1.3.1.linux-arm64.tar.gz

  2. Extract the tarballs.

    tar -xzvf prometheus.tar.gz

    tar -xzvf node_exporter.tar.gz

  3. If you are upgrading from previous versions of prometheus and node-exporter, make a backup. You may delete these folders if they do not contain anything useful.

    mv prometheus prometheus-bak

    mv node_exporter node_exporter-bak

  4. Rename the folders with the following commands.

    mv prometheus-2.36.2.linux-arm64 prometheus

    mv node_exporter-1.3.1.linux-arm64 node_exporter

  5. Follow the guide written in README.txt contained in the $HOME directory after installing cnode, scripts and services to start the services accordingly.

    more ~/README.txt

General Troubleshooting

  1. If you have trouble with port forwarding via SSH, run the following command

    sudo nano /etc/ssh/sshd_config

    Then edit the line AllowTcpForwarding no to AllowTcpForwarding yes. Make sure this line is not commented with #.

  2. If you run into a situation where you get the error:

    /lib/rc/sh/openrc-run.sh: source: line 10: can't open '/home//cnode_env': No such file or directory

    Do the following:

    export USER=$(whoami)
sudo ash -c "echo 'export USER=$USER' >> /etc/profile"

    Then reboot:

    sudo reboot