https://github.com/jokob-sk/NetAlertX Skip to content Navigation Menu Toggle navigation Sign in * Product + Actions Automate any workflow + Packages Host and manage packages + Security Find and fix vulnerabilities + Codespaces Instant dev environments + GitHub Copilot Write better code with AI + Code review Manage code changes + Issues Plan and track work + Discussions Collaborate outside of code Explore + All features + Documentation + GitHub Skills + Blog * Solutions By size + Enterprise + Teams + Startups By industry + Healthcare + Financial services + Manufacturing By use case + CI/CD & Automation + DevOps + DevSecOps * Resources Topics + AI + DevOps + Security + Software Development Explore + Learning Pathways + White papers, Ebooks, Webinars + Customer Stories + Partners * Open Source + GitHub Sponsors Fund open source developers + The ReadME Project GitHub community articles Repositories + Topics + Trending + Collections * Enterprise + Enterprise platform AI-powered developer platform Available add-ons + Advanced Security Enterprise-grade security features + GitHub Copilot Enterprise-grade AI features + Premium Support Enterprise-grade 24/7 support * Pricing Search or jump to... Search code, repositories, users, issues, pull requests... Search [ ] Clear Search syntax tips Provide feedback We read every piece of feedback, and take your input very seriously. [ ] [ ] Include my email address so I can be contacted Cancel Submit feedback Saved searches Use saved searches to filter your results more quickly Name [ ] Query [ ] To see all available qualifiers, see our documentation. Cancel Create saved search Sign in Sign up Reseting focus You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert {{ message }} jokob-sk / NetAlertX Public * * Notifications You must be signed in to change notification settings * Fork 112 * Star 2.1k WIFI / LAN intruder detector. Scans for devices connected to your network and alerts you if new and unknown devices are found. License GPL-3.0 license 2.1k stars 112 forks Branches Tags Activity Star Notifications You must be signed in to change notification settings * Code * Issues 8 * Pull requests 1 * Discussions * Actions * Projects 0 * Security * Insights Additional navigation options * Code * Issues * Pull requests * Discussions * Actions * Projects * Security * Insights jokob-sk/NetAlertX This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository. main BranchesTags Go to file Code Folders and files Last Last Name Name commit commit message date Latest commit History 3,352 Commits .github .github back back config config db db dockerfiles dockerfiles docs docs front front install install server server test test .dockerignore .dockerignore .env .env .gitignore .gitignore CONTRIBUTING CONTRIBUTING Dockerfile Dockerfile Dockerfile.debian Dockerfile.debian FUNDING.yml FUNDING.yml LICENSE.txt LICENSE.txt README.md README.md docker-compose.yml docker-compose.yml update_sponsors.py update_sponsors.py update_sponsors_requirements.txt update_sponsors_requirements.txt View all files Repository files navigation * README * GPL-3.0 license 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). GitHub Committed Docker Size Docker Pulls GitHub Release GitHub Sponsors Docker hub Docker guide Release notes All Docs Main screen device_details 1 Screen network network_setup Head to https://netalertx.com/ for more gifs and screenshots . Click for more screenshots presence maintenance settings sync_hub report1 device_nmap 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 GitHub 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 --------------------------------------------------------------------- GitHub Buy Me A Coffee Patreon * 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... Everything else Translations Proudly using Weblate. Translation status Help out and suggest languages in the online portal of Weblate. License GPL 3.0 | Read more here | Source of the animated GIF (Loading Animation) | Source of the selfhosted Fonts About WIFI / LAN intruder detector. Scans for devices connected to your network and alerts you if new and unknown devices are found. Topics docker security networking selfhosted pi-hole intrusion-detection wifi-network network-analysis arp-scan ipam wifi-security network-security Resources Readme License GPL-3.0 license Activity Stars 2.1k stars Watchers 14 watching Forks 112 forks Report repository Releases 24 v24.7.18 - TP-Link Omada Support, NetBIOS scan, MQTT, UI Enhancements Latest Jul 18, 2024 + 23 releases Sponsor this project Sponsor Learn more about GitHub Sponsors Contributors 30 * @jokob-sk * @github-actions[bot] * @weblate * @mapi68 * @SirAfino * @YoSafeguard * @FlyingToto * @IsuckPOTATO * @ulrichwisser * @realgooseman * @lookflying * @PrinsGeryha * @ingoratsdorf + 16 contributors Languages * HTML 41.5% * Python 17.0% * JavaScript 14.3% * PHP 12.9% * Less 8.1% * CSS 5.3% * Other 0.9% Footer (c) 2024 GitHub, Inc. Footer navigation * Terms * Privacy * Security * Status * Docs * Contact * Manage cookies * Do not share my personal information You can't perform that action at this time.