Backup your SD card

Please refer to this guide for instructions on how to reformat your SD card. Be aware that this procedure should not be performed frequently. It's primarily intended for situations where the files on your SD card have been deleted, or if you're using an SD card that you've provided yourself, rather than one supplied by KasarLabs.

In this tutorial, you will learn how to accomplish the following tasks:

1. Utilize RasberryPi software to add our operating system to your SD card

2. Connect the SD card to your7node, following the typical Starknode setup process

3. Establish a connection between your PC and the Starknode

Follow these steps to complete the tutorial successfully:

1. Take your SD card and insert it into your PC

2. Next, download 'Kasar.img' and the 'raspberryPi' imager (i.e., a software that adds our OS to your SD card)

3. Open the RasberryPi Imager and click on 'CHOOSE OS'

Select 'CHOOSE OS'

1. Select a custom Operating System and the 'kasar.img'

Scroll down and select 'Use custom'

Select 'kasar.img'

1. Next, click on 'CHOOSE STORAGE', select the SD card and select 'write'

Select 'CHOOSE STORAGE'

Select the SD card storage option

Once the Operating System and the Storage have been selected, click on 'WRITE'

Click 'YES' on this pop-up message

Wait a couple of minutes

1. After you have finished writing, please remove the SD card from your device and then insert it back into your PC. This step is necessary because Raspberry Pi Imager will automatically eject the card once the writing process is complete

Your SD card should now be renamed to 'boot'

Launch the KasarGUI. Follow our tutorial:

1. Choose to 'Setup my Starknode, Login or Sign-up and, select the micro SD card

2. Next, safely eject the card, insert it into your node and, plug your node to an electrical outlet and Ethernet

3. Once your node is on, you can use the 'angryBirdIp' scanner, available for Windows, Mac and Linux, to find the local IP of your node

4. In angryBirdIp, Press 'Start'. Once the scanning is complete (it should take approximately 10s to 20s), click on the 'Hostname' column and select 'Sort by Hostname'

5. Find your device, it should have the following name 'rasberrypi.local'

Please note, your device may not always have an assigned name, for instance, it could show as 'n/a' instead of 'raspberrypi.local'. If this happens, identify all the IP addresses marked with a blue dot and proceed with step 6 and the following steps using these IP addresses.

In summary, you can confirm a successful connection to your Starknode when, on MacOS or Linux, your terminal responds to the command ssh starknode@ip_address

On Windows, add the IP Address to ''Host Name (or IP address)'

1. Copy and paste the IP address of the device, located on the first column called 'IP'

2. Connect your Starknode through SSH

   For MacOS and Linux:

   1. Next, open your terminal and execute the following command by changing 'your_ip_address' with the IP you just got from 'angryBirdIp': ssh starknode@your_ip_address.So for example, if my IP is 192.168.1.29, I will copy+paste the following command into my terminal: ssh starknode@192.168.1.29

   2. Input the following password: !KasarOs

   3. Once the process is finished, execute this command sudo /boot/efi/src/run.sh

   4. Now, your connection should be closed

   5. Congrats! If you made it this far, you successfully reformatted your card, ran your node, and connected it to the internet ⚡️

   For Windows:

   1. Download 'PuTTY' a free SSH and telnet client for Windows

   2. Open PuTTY, head to 'Host Name (or IP address)', add the IP address from your node, and click on 'Open'

      

      PuTTY interface on Windows
   3. Next, input starknode, next, the password (!KasarOs), and finally paste sudo /boot/efi/src/run.sh by right-clicking on the console

      

      Console
   4. Press Enter

   5. Congrats, if you made it this far you reformatted your card on Windows ⚡️