PieBoard Client

To create a PieBoard

1. Download Raspberry Pi OS Lite from the Raspberry Pi Website
   • Tested with https://downloads.raspberrypi.org/raspios_lite_armhf/images/raspios_lite_armhf-2021-05-28/
2. Write the image to a micro SD card, documentation for different operating systems can be found on the Raspberry Pi Website
3. Insert the SD card into your Raspberry Pi, it is recommended you also install a case and cooler on the Pi
4. Connect the Pi to the internet, whether that be over ethernet or Wi-Fi
5. Download the setup.sh file provided in this repository. (wget recommended, do NOT clone the repository)
   • wget https://go.kingsridgecs.org/digsig --output-document=setup.sh
6. make the file executable, chmod +x setup.sh
7. run the file, ./setup.sh
8. the default password is raspberry, this will prompt you to change it
9. after the password is changed, the device will automatically reconfigure and reboot
10. after the reboot, you should be greeted by the PieBoard setup screen, if not, you may need to redo the setup process
11. The interface will list a code and device IP addresses, access your Pieboard Server over the Pieboard Interface configured seperately
12. Add a new device (Device dropdown > New)
13. Type the IP address and Device Code shown and hit setup.
14. If successful, the device will be added and you can now push updates. If this process failed, your network may be misconfigured or the device had an error. Check the PieBoard Server logs and the device logs, this can be done by attaching a keyboard and entering Ctrl+Q, or by killing the process over SSH and running pkill electron)

Note: Device clocks may become desynced after a period of time, a cron job may need to be configured to update the times.

Note: This process modifies configuration files that makes the Pi Read-Only, PieBoard is only meant to run on dedicated devices!

Systems on PieBoard V1: the v2 update has made many changes to how writing works on the SD Cards, the v2 update may install properly without any extra changes, however any benefits to SD Card longevity will not be applied without a re-install. Some elements on PieBoard may not work without the full re-install.