RaspiSearch Installation Guide

Setup instructions for Raspberry Pi devices

Prerequisites: This guide assumes you are connected to your Raspberry Pi via monitor, mouse, and keyboard.
1 Login and Create Scripts Folder
  • Login to your Raspberry Pi as user pi
  • Create the scripts folder in the home directory:
mkdir scripts
cd scripts
2 Download Python3 Script

Download the script to /home/pi/scripts/netinfo.py

Option A: Download here and upload via WINSCP

Option B: Use wget:

wget https://services01.htl-braunau.at/raspiSearch/downloads/netinfo.py -O netinfo.py
3 Make Script Executable

Set proper permissions for the script:

chmod 755 /home/pi/scripts/netinfo.py
755 allows: Owner (pi) can read/write/execute, root can read/execute. This is secure and allows both manual testing by user pi and automatic execution by root via crontab.
4 Configure Script Settings

Edit the script configuration (normally not necessary):

  • SERVICEURL - Server URL
  • GROUP - Group name for organizing devices
  • EXPECTED_UPDATE_INTERVALL - Update interval in minutes
  • ENTRY_LIFETIME - Entry lifetime in minutes
  • ifaceFilterList - Network interfaces to monitor
5 Set Unique Hostname

Option A: Use raspi-config:

sudo raspi-config

Option B: Edit manually:

sudo nano /etc/hostname
sudo nano /etc/hosts

Then reboot:

sudo reboot now
6 Test the Script
./netinfo.py
Verify the script runs without errors
7 Setup Cronjob

Add the script to crontab to run every minute:

sudo nano /etc/crontab

Add this line at the end:

*/1 * * * * root /home/pi/scripts/netinfo.py
8 Reboot System
sudo reboot now
Entry should appear in the main view after 2 minutes
9 Change Default Password
passwd
Important for security!
10 Enable Remote Services (Optional)

Update system:

sudo apt-get update

Install xRDP for Windows Remote Desktop:

sudo apt-get install xrdp

Install and enable SSH:

sudo apt-get install ssh
sudo systemctl enable ssh
sudo systemctl start ssh
11 All Done!

Your Raspberry Pi is now registered with RaspiSearch. Have fun! 🎉