π»π WIFI / LAN intruder detector.
Scans for devices connected to your WIFI / LAN and alerts you if new and unknown devices are found.
π³ Docker hub | π Docker guide | π Release notes | π All Docs
The system continuously scans the network for, New devices, New connections (re-connections), Disconnections, "Always Connected" devices down, Devices IP changes and Internet IP address changes. Discovery & scan methods include:
- arp-scan. The arp-scan system utility is used to search for devices on the network using arp frames.
- Pi-hole - DB import. The PiHole database is used as a source for events for devices
- Pi-hole - DHCP leases. Import of devices from the PiHole dhcp.leases file
- Generic DHCP leases. Import of devices from the generic dhcp.leases file
- UNIFI import. Import of devices from the UNIFI controller
- SNMP-enabled router import. Import of devices from an SNMP-enabled router
- Apprise, Pushsafer, NTFY
- Webhooks
- Home Assistant
- API endpoint
- Plugin system for custom scripts monitoring and framework for extending the app
β Only tested as a docker container - follow the guide here.
Check out leiweibau's fork if you want to install Pi.Alert on the server directly or check instructions for pucherot's original code
- Display:
- Sessions, Connected devices, Favorites, Events, Presence, Concurrent devices, Down alerts, IP's
- Manual Nmap scans, Optional speedtest for Device "Internet"
- Simple Network relationship display
- Maintenance tasks and Settings like:
- Theme Selection (blue, red, green, yellow, black, purple) and Light/Dark-Mode Switch
- DB maintenance, Backup, Restore tools and CSV Export / Import
- Simple login Support
- πPlugin system
- Create custom plugins with automatically generated settings and UI.
- Monitor anything for changes
- Check the instructions carefully if you are up for a challenge! Current plugins include:
- Detecting Rogue DHCP servers via NMAP
- Monitoring HTTP status changes of domains/URLs
- Import devices from DHCP.leases files, a UniFi controller, or an SNMP enabled router
- Creation of dummy devices to visualize your network map
- WatchYourLAN - Lightweight network IP scanner with web GUI (Open source)
- Fing - Network scanner app for your Internet security (Commercial, Phone App, Proprietary hardware)
- Initial Docker Setup: Docker instructions
- App Usage and Configuration: All Documentation
GPL 3.0 | Read more here | Source of the animated GIF (Loading Animation) | Source of the selfhosted Fonts
This code is a collaborative body of work, with special thanks to:
- π pucherot/Pi.Alert is the original creator od PiAlert
- leiweibau: Dark mode (and much more)
- Macleykun: Help with Dockerfile clean-up
- Final-Hawk: Help with NTFY, styling and other fixes
- TeroRERO: Spanish translation
- Data-Monkey: Split-up of the python.py file and more
- Please see the Git contributors for a full list of people and their contributions to the project
BTC: 1N8tupjeCK12qRVU2XrV17WvKK7LCawyZM