[{"_1":2,"_152":-5,"_153":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_131":132},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_124":-5,"_125":11,"_126":17,"_127":11,"_128":-5,"_129":130},"canonicalUrl","https://hub.docker.com/r/mglennon/netalertx/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","mglennon","reponame","netalertx","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2024-04-19T01:32:30.426436Z","description","","is_private","last_updated","2024-04-19T12:21:05.562062Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",881,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# 💻🔍 Network security scanner & notification framework\n\nGet 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](https://github.com/jokob-sk/NetAlertX/tree/main/front/plugins#readme) with auto-generated UI and in-build notification system. Build out and easily maintain your network source of truth (NSoT).\n\n[![GitHub Committed](https://img.shields.io/github/last-commit/jokob-sk/NetAlertX?color=40ba12&label=Committed&logo=GitHub&logoColor=fff)](https://github.com/jokob-sk/NetAlertX)\n[![Docker Size](https://img.shields.io/docker/image-size/jokobsk/netalertx?label=Size&logo=Docker&color=0aa8d2&logoColor=fff)](https://hub.docker.com/r/jokobsk/netalertx)\n[![Docker Pulls](https://img.shields.io/docker/pulls/jokobsk/netalertx?label=Pulls&logo=docker&color=0aa8d2&logoColor=fff)](https://hub.docker.com/r/jokobsk/netalertx)\n[![GitHub Release](https://img.shields.io/github/v/release/jokob-sk/NetAlertX?color=0aa8d2&logoColor=fff&logo=GitHub)](https://github.com/jokob-sk/NetAlertX/releases)\n[![GitHub Sponsors](https://img.shields.io/github/sponsors/jokob-sk?style=social)](https://github.com/sponsors/jokob-sk)\n\n | 🐳 [Docker hub](https://registry.hub.docker.com/r/jokobsk/netalertx) | 📑 [Docker guide](https://github.com/jokob-sk/NetAlertX/blob/main/dockerfiles/README.md) |🆕 [Release notes](https://github.com/jokob-sk/NetAlertX/releases) | 📚 [All Docs](https://github.com/jokob-sk/NetAlertX/tree/main/docs) | \n |----------------------|----------------------| ----------------------| ----------------------| \n\n\n | ![Main screen][main] | ![Screen 1][screen1] | ![Screen 5][screen5] |\n |----------------------|----------------------| ----------------------| \n\n

📷 Click for more screenshots

\n\n | ![Screen 3][screen3] | ![Screen 4][screen4] | ![Screen 6][screen6] |\n |----------------------|----------------------|----------------------|\n | ![Screen 8][screen8] | ![Report 2][report2] | ![Screen 9][screen9] |\n\n

\n\n

❓ Why use Net Alert^x?

\n\n

\n\n 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.\n\n Net Alert^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 🔐_. \n\n Net Alert^x combines several network and other scanning tools 🔍 with notifications 📧 into one user-friendly package 📦. \n\n Set up a _kill switch ☠_ for your network via a smart plug with the available [Home Assistant](https://github.com/jokob-sk/NetAlertX/blob/main/docs/HOME_ASSISTANT.md) integration. Implement custom automations with the [CSV device Exports 📤](https://github.com/jokob-sk/NetAlertX/tree/main/front/plugins/csv_backup), [Webhooks](https://github.com/jokob-sk/NetAlertX/blob/main/docs/WEBHOOK_N8N.md), or [API endpoints](https://github.com/jokob-sk/NetAlertX/blob/main/docs/API.md) features. \n\n Extend the app if you want to create your own scanner [Plugin](https://github.com/jokob-sk/NetAlertX/tree/main/front/plugins#readme) and handle the results and notifications in Net Alert^x. \n\n Looking forward to your contributions if you decide to share your work with the community ❤.\n\n

\n\n## Scan Methods, Notifications, Integration, Extension system\n\n| Features | Details | \n|-------------|-------------|\n| 🔍 | 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](https://github.com/jokob-sk/NetAlertX/tree/main/front/plugins#readme) docs for more info on individual scans. |\n|📧 | Send notifications to more than 80+ services, including Telegram via [Apprise](https://hub.docker.com/r/caronc/apprise), or use [Pushsafer](https://www.pushsafer.com/), [Pushover](https://www.pushover.net/), or [NTFY](https://ntfy.sh/). |\n|🧩 | Feed your data and device changes into [Home Assistant](https://github.com/jokob-sk/NetAlertX/blob/main/docs/HOME_ASSISTANT.md), read [API endpoints](https://github.com/jokob-sk/NetAlertX/blob/main/docs/API.md), or use [Webhooks](https://github.com/jokob-sk/NetAlertX/blob/main/docs/WEBHOOK_N8N.md) to setup custom automation flows. |\n|➕ | Build your own scanners with the [Plugin system](https://github.com/jokob-sk/NetAlertX/tree/main/front/plugins#readme) |\n\n\n## Installation & Documentation\n\n\n| Docs | Link | \n|-------------|-------------|\n| 📥🐳 | [Docker instructions](https://github.com/jokob-sk/NetAlertX/blob/main/dockerfiles/README.md) \n| 📥💻 | [HW install (experimental 🧪)](https://github.com/jokob-sk/NetAlertX/blob/main/docs/HW_INSTALL.md) |\n| 📚 | [All Documentation](https://github.com/jokob-sk/NetAlertX/blob/main/docs/README.md) (App Usage and Configuration) |\n \n> Other Alternatives\n>\n> - Check out [leiweibau's on HW installed fork](https://github.com/leiweibau/Pi.Alert/) (maintained)\n> - Check instructions for [pucherot's original code](https://github.com/pucherot/Pi.Alert/) (unmaintained)\n> - [WatchYourLAN](https://github.com/aceberg/WatchYourLAN) - Lightweight network IP scanner with web GUI (Open source)\n> - [Fing](https://www.fing.com/) - Network scanner app for your Internet security (Commercial, Phone App, Proprietary hardware)\n> - [NetBox](https://netboxlabs.com/) - Network management software (Commercial)\n\n### ⭐ Sponsors\n\n[![GitHub Sponsors](https://img.shields.io/github/sponsors/jokob-sk?style=social)](https://github.com/sponsors/jokob-sk)\n\nThank you to all the wonderful people who are sponsoring this project. \n\n> preventing my burnout😅 are:\n\n\n| All Sponsors |\n|---|\n\n\n\n| [![GitHub](https://i.imgur.com/emsRCPh.png)](https://github.com/sponsors/jokob-sk) | [![Buy Me A Coffee](https://i.imgur.com/pIM6YXL.png)](https://www.buymeacoffee.com/jokobsk) | [![Patreon](https://i.imgur.com/MuYsrq1.png)](https://www.patreon.com/user?u=84385063) | \n| --- | --- | --- | \n\n

Click for more ways to donate

\n \n

\n\n - Bitcoin: `1N8tupjeCK12qRVU2XrV17WvKK7LCawyZM`\n - Ethereum: `0x6e2749Cb42F4411bc98501406BdcD82244e3f9C7`\n\n 📧 Email me at [jokob@duck.com](mailto:jokob@duck.com?subject=NetAlertX) if you want to get in touch or if I should add other sponsorship platforms.\n\n

\n\n### 🙏Contributors\n\nThis project would be nothing without the amazing work of the community, with special thanks to: \n\n> [pucherot/Pi.Alert](https://github.com/pucherot/Pi.Alert) (the original creator of PiAlert), [leiweibau](https://github.com/leiweibau/Pi.Alert): Dark mode (and much more), [Macleykun](https://github.com/Macleykun) (Help with Dockerfile clean-up) [Final-Hawk](https://github.com/Final-Hawk) (Help with NTFY, styling and other fixes), [TeroRERO](https://github.com/terorero) (Spanish translations), [Data-Monkey](https://github.com/Data-Monkey), (Split-up of the python.py file and more), [cvc90](https://github.com/cvc90) (Spanish translation and various UI work) to name a few...\n\nHere is everyone that helped and contributed to this project:\n\n\n

\n\n\n## Everything else\n\n\n### 🌍 Translations \n\nProudly using [Weblate](https://hosted.weblate.org/projects/pialert/).\n\n\n $\"Translation$ \n\n\nHelp out and suggest languages in the [online portal of Weblate](https://hosted.weblate.org/projects/pialert/core/).\n\n### License\n> GPL 3.0 | [Read more here](LICENSE.txt) | Source of the [animated GIF (Loading Animation)](https://commons.wikimedia.org/wiki/File:Loading_Animation.gif) | Source of the [selfhosted Fonts](https://github.com/adobe-fonts/source-sans)\n \n\n\n\n[main]: ./docs/img/devices_split.png \"Main screen\"\n[screen1]: ./docs/img/device_details.png \"Screen 1\"\n[screen2]: ./docs/img/events.png \"Screen 2\"\n[screen3]: ./docs/img/presence.png \"Screen 3\"\n[screen4]: ./docs/img/maintenance.png \"Screen 4\"\n[screen5]: ./docs/img/network.png \"Screen 5\"\n[screen6]: ./docs/img/settings.png \"Screen 6\"\n[screen7]: ./docs/img/help_faq.png \"Screen 7\"\n[screen8]: ./docs/img/plugins_rogue_dhcp.png \"Screen 8\"\n[screen9]: ./docs/img/device_nmap.png \"Screen 9\"\n[report1]: ./docs/img/4_report_1.jpg \"Report sample 1\"\n[report2]: ./docs/img/4_report_2.jpg \"Report sample 2\"\n[main_dark]: /docs/img/1_devices_dark.jpg \"Main screen dark\"\n[maintain_dark]: /docs/img/5_maintain.jpg \"Maintain screen dark\"\n\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",81743168,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":98,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},"content_type","creator",10969075,"digest","sha256:8dce391339ad0ff85245a322b36fa06e95fbb32a8ff176d7c44154aed0a5e674","full_size",81738385,"id",644279635,"images",[99],{"_100":101,"_91":92,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":94,"_59":62,"_112":-5},"architecture","amd64","features","last_pulled","2026-09-19T00:38:58.584299167Z","last_pushed","2024-04-19T12:21:05Z","os","linux","os_features","os_version","size","variant","2024-04-19T12:21:05.539848Z","last_updater","last_updater_username","media_type","latest","repository",23872548,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":133,"_140":141,"_129":150,"_151":11},{"_36":134,"_38":135,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":136,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":137,"_75":11,"_76":139,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":138},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_142":60,"_143":-5,"_144":-5,"_145":146},"count","next","previous","results",[147],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":148,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},[149],{"_100":101,"_91":92,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":94,"_59":62,"_112":-5},[],"canDeleteTags","actionData","errors"]

mglennon/netalertx

Tags for mglennon/netalertx