Pi.Alert

💻🔍 WIFI / LAN intruder detector.

Scans for devices connected to your WIFI / LAN and alerts you if new and unknown devices are found.

🐳 Docker image

🐳 Docker hub | 📑 Docker guide | 🆕 Release notes | 📚 All Docs

🔍 Scan Methods

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

🧩 Integrations

• Apprise, Pushsafer, NTFY
• Webhooks
• Home Assistant
• API endpoint
• Plugin system for custom scripts monitoring and framework for extending the app

📥 Installation

⚠ 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

📑 Features

• 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

🔗 Other Alternatives

• WatchYourLAN - Lightweight network IP scanner with web GUI (Open source)
• Fing - Network scanner app for your Internet security (Commercial, Phone App, Proprietary hardware)

📚 Documentation

• Initial Docker Setup: Docker instructions
• App Usage and Configuration: All Documentation

License

GPL 3.0 | Read more here | Source of the animated GIF (Loading Animation) | Source of the selfhosted Fonts

🥇 Special thanks

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

☕ Support me

BTC: 1N8tupjeCK12qRVU2XrV17WvKK7LCawyZM