How to install pib´s software on Raspberry Pi

For pib to work, it is necessary to install pib.software on your Raspberry Pi.

This tutorial consists of 3 main steps:

Downloading and installing Ubuntu on a Raspberry Pi
Setting up Ubuntu
Installing pib.software

To follow this tutorial, you will need

A device that can read a micro SD card (You may need an adapter for this to work)
The (USB-C) power supply of the Raspberry Pi
A keyboard and mouse
A display and a matching micro HDMI adapter (For example: to connect the Raspberry Pi to a HDMI display, you need a micro HMDI to HMDI adapter)

start

Step 1a

Put the micro SD card into a device that can read a SD card (a laptop or PC).
You may need an adapter for this to work.

Step 1b

Download Raspberry Pi imager from https://www.raspberrypi.com/software

Step 1c

Install Raspberry Pi imager.

Step 1d

After installation click on „Finish“ and launch the application.

Step 1e

Lauch imager and click on „Choose Device“.
Then click on „Raspberry Pi 4“.

Step 1f

Select „Other general-purpose OS“.

Step 1g

Select „Ubuntu“ then „Ubuntu 22.04.4 LTS desktop version 64-bit“.

Please note: you can select a newer version too, but it is important to select Ubuntu 22.04.x

Step 1h

Choose your storage device – make sure to select the micro SD card.
Please note: all existing data on a pre-used card will be erased.

Step 1i

Click on „Write“ to start installing Ubuntu on the storage medium and wait until the process is finished.
Then click on „Continue“ to end Step 1.

Step 2a

Remove the micro SD card from laptop/PC and insert it to the Raspberry Pi.

Step 2b

Connect the Raspberry Pi to your power supply, a HDMI capable screen/display and a keyboard and mouse for the next steps.
After connecting the raspberry pi to the display and power supply, it should show the Ubuntu loading screen.
After it has finished loading the Ubuntu Installation setup should start.

Step 2c

Select a matching layout for the keyboard you’re using.

Step 2d

Select your local time zone and set “pib” as username and password.

Step 2e

Wait for the installation to be finalized. This may take some time.

Step 3a

Open firefox and navigate to the pib.software setup page on Github using this link: https://github.com/pib-rocks/pib-backend
You will need these 3 commands to continue the pib.software setup.

Step 3b

At first, launch the terminal. You may need to type “Terminal” into the search bar to find the app.

Step 3c

The first command will download the setup-script from our github website.
– Copy the command from github (wget https://raw.githubusercontent.com/…)
– Paste it into the terminal
– Press enter to execute the command

Info: If the download isn’t working you can also download the file manually via github

Step 3d

The second command makes the downloaded script executable.
Copy the command from github (chmod …) and paste it into the terminal like in the first step.

Step 3e

The third command starts the setup script. Therefore, enter the command in the terminal.
The setup process will take quite some time, depending on your internet connection (upwards of 40 minutes).