Pi.Alert Installation Guide

Learn how to install and configure Pi.Alert on Raspberry Pi with this step-by-step guide. Monitor your network devices easily and improve home network security.

1. Update Software Repositories

sudo apt update

2. Install Available Software Updates

sudo apt upgrade -y

3. Install Prerequisites

sudo apt install apt-utils arp-scan dnsutils net-tools python3 -y

4. Install Web & Database Components

sudo apt install lighttpd php php-cgi php-fpm php-sqlite3 sqlite3 -y

5. Clean APT Package Cache

sudo apt clean

6. Download the Latest Release

wget -O ./pialert.tar https://github.com/pucherot/Pi.Alert/...

7. Create Required Directories

sudo mkdir /var/www/pialert
sudo mkdir /var/log/pialert

8. Extract the Downloaded Archive

sudo tar xf ./pialert.tar -C /var/www/pialert --strip-components=1

9. Set Ownership of Pi.Alert Directory

sudo chown -R www-data:www-data /var/www/pialert

10. Update Pi.Alert Path in Config File

sed -i 's/\/home\/pi\/pialert/\/var\/www\/pialert/' /var/www/pialert/config/pialert.conf

11. Update Pi.Alert Path in Cron Jobs

sed -i 's/python ~\/pialert\/back\/pialert.py/python3 \/var\/www\/pialert\/back\/pialert.py/g' /var/www/pialert/install/pialert.cron

12. Update Log Paths for Cron Jobs

sed -i 's/~\/pialert\/log\//\/var\/log\/pialert\//g' /var/www/pialert/install/pialert.cron

13. Create Cronjob Schedule

(crontab -l 2>/dev/null; cat /var/www/pialert/install/pialert.cron) | sudo crontab -

14. Create Symbolic Link to Pi.Alert

sudo ln -s /var/www/pialert/front/ /var/www/html/pialert

15. Configure Lighttpd

Copy Pi.Alert Lighttpd configuration:

sudo cp /var/www/pialert/install/pialert_front.conf /etc/lighttpd/conf-available

Enable the Pi.Alert configuration:

sudo ln -s /etc/lighttpd/conf-available/pialert_front.conf /etc/lighttpd/conf-enabled/pialert_front.conf

Enable FastCGI for PHP:

sudo lighttpd-enable-mod fastcgi-php

Restart Lighttpd service:

sudo systemctl restart lighttpd

✅ Installation Complete

Pi.Alert should now be accessible via your server’s IP address:

http://<your-server-ip>/pialert