# PiAlert

PiAlert is a self-hosted network monitoring tool that discovers and tracks devices on your Wi-Fi and LAN, alerting you when unknown devices appear or known ones go offline. It is open source and self-hosted, installable on Proxmox and ZimaOS.

Canonical page: https://ourlocalhost.com/app/4577/pialert

## Description

Pi.Alert is a self-hosted network monitoring tool that discovers and tracks devices on your Wi-Fi and LAN, alerting you when unknown devices appear or known ones go offline. It detects rogue DHCP (dynamic host configuration protocol) servers, monitors internal and external web services via HTTP status, response time, and SSL certificate checks, and supports ICMP (internet control message protocol) monitoring for devices outside the local subnet. The built-in web interface provides a single dashboard for home and small-office network operators to manage device visibility and service reliability.

## Platform availability

Available on 2 of 10 platforms: ZimaOS, Proxmox.

## Health score

72/100 (Good), based on 3 of 4 factors.
- Maintained: 99 (last commit 36 days ago)
- Popular: 63 (1,359 GitHub stars)
- Easy to install: 30 (2 install platforms, Docker image)

## Links

- Official website: https://leiweibau.net
- GitHub: https://github.com/leiweibau/Pi.Alert
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=pialert
- ZimaOS: https://github.com/bigbeartechworld/big-bear-casaos/tree/master/Apps/pi-alert

## Common questions

### Is there a Dockerized Pi.Alert deployment example?

A self-hosted thread describes a Dockerized Pi.Alert setup for LAN intrusion detection.

### Can Pi.Alert be controlled from the command line?

The repository documentation lists pialert-cli and pialert.conf, indicating command-line use and a configuration file.

### Does Pi.Alert provide API documentation?

The repository documentation lists API usage.

### Can Pi.Alert alert me when an unknown device connects?

Yes, it scans Wi-Fi and LAN devices and can alert when unknown devices connect.

---
Source: Our Local Host (https://ourlocalhost.com/app/4577/pialert), the self-hosted and open-source app directory.
