🖧🔍 Network scanner & notification framework

Get visibility of what's going on on your WIFI/LAN network. Schedule scans for devices, port changes and get alerts if unknown devices or changes are found. Write your own Plugins with auto-generated UI and in-build notification system. Build out and easily maintain your network source of truth (NSoT).

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

network_setup

Head to https://netalertx.com/ for more gifs and screenshots 📷.

📷 Click for more screenshots

❓ Why use NetAlert^x?

Most of us don't know what's going on on our home network, but we want our family and data to be safe. Command-line tools are great, but the output can be hard to understand and action if you are not a network specialist.

NetAlert^x gives you peace of mind. Visualize and immediately report 📬 what is going on in your network - this is the first step to enhance your network security 🔐.

NetAlert^x combines several network and other scanning tools 🔍 with notifications 📧 into one user-friendly package 📦.

Set up a kill switch ☠ for your network via a smart plug with the available Home Assistant integration. Implement custom automations with the CSV device Exports 📤, Webhooks, or API endpoints features.

Extend the app if you want to create your own scanner Plugin and handle the results and notifications in NetAlert^x.

Looking forward to your contributions if you decide to share your work with the community ❤.

Scan Methods, Notifications, Integration, Extension system

Features	Details
🔍	The app scans your 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, Pi-hole - DB import, Pi-hole - DHCP leases import, Generic DHCP leases import. UNIFI controller import, SNMP-enabled router import. Check the Plugins docs for more info on individual scans.
📧	Send notifications to more than 80+ services, including Telegram via Apprise, or use Pushsafer, Pushover, or NTFY.
🧩	Feed your data and device changes into Home Assistant, read API endpoints, or use Webhooks to setup custom automation flows.
➕	Build your own scanners with the Plugin system

Installation & Documentation

Docs	Link
📥🐳	Docker instructions
📥🗄️	HW install (experimental 🧪)
📥🟧	Unraid App
📚	All Documentation (App Usage and Configuration)

Other Alternatives

Check out leiweibau's on HW installed fork (maintained)

WatchYourLAN - Lightweight network IP scanner with web GUI (Open source)

Fing - Network scanner app for your Internet security (Commercial, Phone App, Proprietary hardware)

NetBox - Network management software (Commercial)

🔔 Get notified what's new

Get notified about a new release, what new functionality you can use and about breaking changes.

Follow and star

⭐ Sponsors

Thank you to all the wonderful people who are sponsoring this project.

preventing my burnout😅 are:

All Sponsors

Click for more ways to donate

Bitcoin: 1N8tupjeCK12qRVU2XrV17WvKK7LCawyZM
Ethereum: 0x6e2749Cb42F4411bc98501406BdcD82244e3f9C7

📧 Email me at jokob@duck.com if you want to get in touch or if I should add other sponsorship platforms.

🙏Contributors

This project would be nothing without the amazing work of the community, with special thanks to:

pucherot/Pi.Alert (the original creator of PiAlert), leiweibau: Dark mode (and much more), Macleykun (Help with Dockerfile clean-up) Final-Hawk (Help with NTFY, styling and other fixes), TeroRERO (Spanish translations), Data-Monkey, (Split-up of the python.py file and more), cvc90 (Spanish translation and various UI work) to name a few...