[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-71109":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":25,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":41,"readmeContent":42,"aiSummary":43,"trendingCount":16,"starSnapshotCount":16,"syncStatus":44,"lastSyncTime":45,"discoverSource":46},71109,"NetAlertX","netalertx\u002FNetAlertX","netalertx","Centralized network visibility and continuous asset discovery.  Monitor devices, detect change, and stay aware across distributed networks.","https:\u002F\u002Fnetalertx.com",null,"Python",6536,410,30,17,0,16,25,102,48,106.34,"GNU General Public License v3.0",false,"main",true,[27,28,29,30,31,32,33,34,35,36,37,38,39,40],"arp-scan","asset-management","dcim","ipam","network-analysis","network-automation","network-monitoring","network-security","networking","security","selfhosted","sysadmin","wifi-network","wifi-security","2026-06-12 04:00:59","[![Docker Size](https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fimage-size\u002Fjokobsk\u002Fnetalertx?label=Size&logo=Docker&color=0aa8d2&logoColor=fff&style=for-the-badge)](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fjokobsk\u002Fnetalertx)\n[![Docker Pulls](https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fpulls\u002Fjokobsk\u002Fnetalertx?label=Pulls&logo=docker&color=0aa8d2&logoColor=fff&style=for-the-badge)](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fjokobsk\u002Fnetalertx)\n[![GitHub Release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fnetalertx\u002FNetAlertX?color=0aa8d2&logoColor=fff&logo=GitHub&style=for-the-badge)](https:\u002F\u002Fgithub.com\u002Fnetalertx\u002FNetAlertX\u002Freleases)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F1274490466481602755?color=0aa8d2&logoColor=fff&logo=Discord&style=for-the-badge)](https:\u002F\u002Fdiscord.gg\u002FNczTUTWyRr)\n[![Home Assistant](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FRepo-blue?logo=home-assistant&style=for-the-badge&color=0aa8d2&logoColor=fff&label=Add)](https:\u002F\u002Fmy.home-assistant.io\u002Fredirect\u002Fsupervisor_add_addon_repository\u002F?repository_url=https%3A%2F%2Fgithub.com%2Falexbelgium%2Fhassio-addons)\n\n# NetAlertX - Network Visibility & Asset Intelligence Framework\n\n![main][main]\n\n\u003Cdetails>\n  \u003Csummary>📷 Click for more screenshots\u003C\u002Fsummary>\n\n  | ![Main screen][main] | ![device_details 1][device_details]  | ![Screen network][network] |\n  |----------------------|----------------------|----------------------|\n  | ![presence][presence] | ![maintenance][maintenance] | ![settings][settings]  |\n  | ![sync_hub][sync_hub] | ![report1][report1] | ![device_nmap][device_nmap]  |\n\n  Head to [https:\u002F\u002Fnetalertx.com\u002F](https:\u002F\u002Fnetalertx.com\u002F) for even more gifs and screenshots 📷.\n\n\u003C\u002Fdetails>\n\n\nCentralized network visibility and continuous asset discovery.\n\nMonitor devices, detect change, and stay aware across distributed networks.\n\nNetAlertX provides a centralized \"Source of Truth\" (NSoT) for network infrastructure. Maintain a real-time inventory of every connected device, identify Shadow IT and unauthorized hardware to maintain regulatory compliance, and automate compliance workflows across distributed sites.\n\nNetAlertX is designed to bridge the gap between simple network scanning and complex SIEM tools, providing actionable insights without the overhead.\n\n\n## Table of Contents\n\n- [Quick Start](#quick-start)\n- [Features](#features)\n- [Documentation](#documentation)\n- [Security \\& Privacy](#security--privacy)\n- [FAQ](#faq)\n- [Troubleshooting Tips](#troubleshooting-tips)\n- [Everything else](#everything-else)\n\n## Quick Start\n\n> [!WARNING]\n> ⚠️ **Important:** The docker-compose has recently changed. Carefully read the [Migration guide](https:\u002F\u002Fdocs.netalertx.com\u002FMIGRATION\u002F?h=migrat#12-migration-from-netalertx-v25524) for detailed instructions.\n\nStart NetAlertX in seconds with Docker:\n\n```bash\ndocker run -d \\\n  --network=host \\\n  --restart unless-stopped \\\n  -v \u002Flocal_data_dir:\u002Fdata \\\n  -v \u002Fetc\u002Flocaltime:\u002Fetc\u002Flocaltime:ro \\\n  --tmpfs \u002Ftmp:uid=20211,gid=20211,mode=1700 \\\n  -e PORT=20211 \\\n  -e APP_CONF_OVERRIDE='{\"GRAPHQL_PORT\":\"20214\"}' \\\n  ghcr.io\u002Fnetalertx\u002Fnetalertx:latest\n```\n\nNote: Your `\u002Flocal_data_dir` should contain a `config` and `db` folder.\n\nTo deploy a containerized instance directly from the source repository, execute the following BASH sequence:\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fnetalertx\u002FNetAlertX.git\ncd NetAlertX\ndocker compose up --force-recreate --build\n# To customize: edit docker-compose.yaml and run that last command again\n```\n\nNeed help configuring it? Check the [usage guide](https:\u002F\u002Fdocs.netalertx.com\u002FREADME) or [full documentation](https:\u002F\u002Fdocs.netalertx.com\u002F).\n\nFor Home Assistant users: [Click here to add NetAlertX](https:\u002F\u002Fmy.home-assistant.io\u002Fredirect\u002Fsupervisor_add_addon_repository\u002F?repository_url=https%3A%2F%2Fgithub.com%2Falexbelgium%2Fhassio-addons)\n\nFor other install methods, check the [installation docs](#documentation)\n\n---\n### || [Docker guide](https:\u002F\u002Fdocs.netalertx.com\u002FDOCKER_INSTALLATION) || [Releases](https:\u002F\u002Fgithub.com\u002Fnetalertx\u002FNetAlertX\u002Freleases) || [Docs](https:\u002F\u002Fdocs.netalertx.com\u002F) || [Plugins](https:\u002F\u002Fdocs.netalertx.com\u002FPLUGINS) || [Website](https:\u002F\u002Fnetalertx.com)\n---\n\n## Features\n\n### Discovery & Asset Intelligence\n\nContinuous monitoring for unauthorized asset discovery, connection state changes, and IP address management (IPAM) drift. 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:\u002F\u002Fdocs.netalertx.com\u002FPLUGINS#readme) docs for a full list of avaliable plugins.\n\n### Notification gateways\n\nSend notifications to more than 80+ services, including Telegram via [Apprise](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fcaronc\u002Fapprise), or use native [Pushsafer](https:\u002F\u002Fwww.pushsafer.com\u002F), [Pushover](https:\u002F\u002Fwww.pushover.net\u002F), or [NTFY](https:\u002F\u002Fntfy.sh\u002F) publishers.\n\n### Integrations and Plugins\n\nFeed your data and device changes into [Home Assistant](https:\u002F\u002Fdocs.netalertx.com\u002FHOME_ASSISTANT), read [API endpoints](https:\u002F\u002Fdocs.netalertx.com\u002FAPI), or use [Webhooks](https:\u002F\u002Fdocs.netalertx.com\u002FWEBHOOK_N8N) to setup custom automation flows. You can also\nbuild your own scanners with the [Plugin system](https:\u002F\u002Fdocs.netalertx.com\u002FPLUGINS#readme) in as little as [15 minutes](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=cdbxlwiWhv8).\n\n### Workflows\n\nThe [workflows module](https:\u002F\u002Fdocs.netalertx.com\u002FWORKFLOWS) automates IT governance by enforcing device categorization and cleanup policies. Whether you need to assign newly discovered devices to a specific Network Node, auto-group devices from a given vendor, unarchive a device if detected online, or automatically delete devices, this module provides the flexibility to tailor the automations to your needs.\n\n\n## Documentation\n\u003C!--- --------------------------------------------------------------------- --->\n\nExplore all the [documentation here](https:\u002F\u002Fdocs.netalertx.com\u002F) or navigate to a specific installation option below.\n\nSupported browsers: Chrome, Firefox\n\n- [[Installation] Docker](https:\u002F\u002Fdocs.netalertx.com\u002FDOCKER_INSTALLATION)\n- [[Installation] Home Assistant](https:\u002F\u002Fgithub.com\u002Falexbelgium\u002Fhassio-addons\u002Ftree\u002Fmaster\u002Fnetalertx)\n- [[Installation] Bare metal](https:\u002F\u002Fdocs.netalertx.com\u002FHW_INSTALL)\n- [[Installation] Unraid App](https:\u002F\u002Funraid.net\u002Fcommunity\u002Fapps)\n- [[Setup] Usage and Configuration](https:\u002F\u002Fdocs.netalertx.com\u002FREADME)\n- [[Development] API docs](https:\u002F\u002Fdocs.netalertx.com\u002FAPI)\n- [[Development] Custom Plugins](https:\u002F\u002Fdocs.netalertx.com\u002FPLUGINS_DEV)\n\n## Security & Privacy\n\nNetAlertX scans your local network and can store metadata about connected devices. By default, all data is stored **locally**. No information is sent to external services unless you explicitly configure notifications or integrations.\n\nCompliance & Hardening:\n- Run it behind a reverse proxy with authentication\n- Use firewalls to restrict access to the web UI\n- Regularly update to the latest version for security patches\n- Role-Based Access Control (RBAC) via Reverse Proxy: Integrate with your existing SSO\u002FIdentity provider for secure dashboard access.\n\nSee [Security Best Practices](https:\u002F\u002Fgithub.com\u002Fnetalertx\u002FNetAlertX\u002Fsecurity) for more details.\n\n\n## FAQ\n\n**Q: How do I monitor VLANs or remote subnets?**\nA: Ensure the container has proper network access (e.g., use `--network host` on Linux). Also check that your scan method is properly configured in the UI.\n\n**Q: What is the recommended deployment for high-availability?**\nA: We recommend deploying via Docker with persistent volume mounts for database integrity and running behind a reverse proxy for secure access.\n\n**Q: Will this send any data to the internet?**\nA: No. All scans and data remain local, unless you set up cloud-based notifications.\n\n**Q: Can I use this without Docker?**\nA: You can install the application directly on your own hardware by following the [bare metal installation guide](https:\u002F\u002Fdocs.netalertx.com\u002FHW_INSTALL).\n\n**Q: Where is the data stored?**\nA: In the `\u002Fdata\u002Fconfig` and `\u002Fdata\u002Fdb` folders. Back up these folders regularly.\n\n\n## Troubleshooting Tips\n\n- Some scanners (e.g. ARP) may not detect devices on different subnets. See the [Remote networks guide](https:\u002F\u002Fdocs.netalertx.com\u002FREMOTE_NETWORKS) for workarounds.\n- Wi-Fi-only networks may require alternate scanners for accurate detection.\n- Notification throttling may be needed for large networks to prevent spam.\n- On some systems, elevated permissions (like `CAP_NET_RAW`) may be needed for low-level scanning.\n\nCheck the [GitHub Issues](https:\u002F\u002Fgithub.com\u002Fnetalertx\u002FNetAlertX\u002Fissues) for the latest bug reports and solutions and consult [the official documentation](https:\u002F\u002Fdocs.netalertx.com\u002F).\n\n## Everything else\n\u003C!--- --------------------------------------------------------------------- --->\n\n\u003Ca href=\"https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F12670\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Ftrendshift.io\u002Fapi\u002Fbadge\u002Frepositories\u002F12670\" alt=\"jokob-sk%2FNetAlertX | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"\u002F>\u003C\u002Fa>\n\n### 📧 Get notified what's new\n\nGet notified about a new release, what new functionality you can use and about breaking changes.\n\n![Follow and star][follow_star]\n\n### 🔀 Other Alternative Apps\n\n- [Fing](https:\u002F\u002Fwww.fing.com\u002F) - Network scanner app for your Internet security (Commercial, Phone App, Proprietary hardware)\n- [NetBox](https:\u002F\u002Fnetboxlabs.com\u002F) - The gold standard for Network Source of Truth (NSoT) and IPAM.\n- [Zabbix](https:\u002F\u002Fwww.zabbix.com\u002F) or [Nagios](https:\u002F\u002Fwww.nagios.org\u002F) - Strong focus on infrastructure monitoring.\n- [NetAlertX](https:\u002F\u002Fnetalertx.com) - The streamlined, discovery-focused choice for real-time asset intelligence and noise-free alerting.\n\n### 💙 Donations\n\nThank you to everyone who appreciates this tool and donates.\n\n\u003Cdetails>\n  \u003Csummary>Click for more ways to donate\u003C\u002Fsummary>\n\n  \u003Chr>\n\n  | [![GitHub](https:\u002F\u002Fi.imgur.com\u002FemsRCPh.png)](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fjokob-sk) | [![Buy Me A Coffee](https:\u002F\u002Fi.imgur.com\u002FpIM6YXL.png)](https:\u002F\u002Fwww.buymeacoffee.com\u002Fjokobsk) |\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\u003C\u002Fdetails>\n\n### 🏗 Contributors\n\nThis project would be nothing without the amazing work of the community, with special thanks to:\n\n> [pucherot\u002FPi.Alert](https:\u002F\u002Fgithub.com\u002Fpucherot\u002FPi.Alert) (the original creator of PiAlert), [leiweibau](https:\u002F\u002Fgithub.com\u002Fleiweibau\u002FPi.Alert): Dark mode (and much more), [Macleykun](https:\u002F\u002Fgithub.com\u002FMacleykun) (Help with Dockerfile clean-up), [vladaurosh](https:\u002F\u002Fgithub.com\u002Fvladaurosh) for Alpine re-base help, [Final-Hawk](https:\u002F\u002Fgithub.com\u002FFinal-Hawk) (Help with NTFY, styling and other fixes), [TeroRERO](https:\u002F\u002Fgithub.com\u002Fterorero) (Spanish translations), [Data-Monkey](https:\u002F\u002Fgithub.com\u002FData-Monkey), (Split-up of the python.py file and more), [cvc90](https:\u002F\u002Fgithub.com\u002Fcvc90) (Spanish translation and various UI work) to name a few. Check out all the [amazing contributors](https:\u002F\u002Fgithub.com\u002Fnetalertx\u002FNetAlertX\u002Fgraphs\u002Fcontributors).\n\n### 🌍 Translations\n\nProudly using [Weblate](https:\u002F\u002Fhosted.weblate.org\u002Fprojects\u002Fpialert\u002F). Help out and suggest languages in the [online portal of Weblate](https:\u002F\u002Fhosted.weblate.org\u002Fprojects\u002Fpialert\u002Fcore\u002F).\n\n\u003Ca href=\"https:\u002F\u002Fhosted.weblate.org\u002Fengage\u002Fpialert\u002F\">\n  \u003Cimg src=\"https:\u002F\u002Fhosted.weblate.org\u002Fwidget\u002Fpialert\u002Fcore\u002Fmulti-auto.svg\" alt=\"Translation status\" \u002F>\n\u003C\u002Fa>\n\n### License\n>  GPL 3.0 | [Read more here](LICENSE.txt) | Source of the [animated GIF (Loading Animation)](https:\u002F\u002Fcommons.wikimedia.org\u002Fwiki\u002FFile:Loading_Animation.gif) | Source of the [selfhosted Fonts](https:\u002F\u002Fgithub.com\u002Fadobe-fonts\u002Fsource-sans)\n\n_All product names, logos, and brands are property of their respective owners. All company, product and service names used in this website are for identification purposes only. Use of these names, logos, and brands does not imply endorsement._\n\n\u003C!--- --------------------------------------------------------------------- --->\n[main]:                     .\u002Fdocs\u002Fimg\u002Fdevices_split.png                  \"Main screen\"\n[device_details]:           .\u002Fdocs\u002Fimg\u002Fdevice_details.png                 \"Screen 1\"\n[events]:                   .\u002Fdocs\u002Fimg\u002Fevents.png                         \"Screen 2\"\n[presence]:                 .\u002Fdocs\u002Fimg\u002Fpresence.png                       \"Screen 3\"\n[maintenance]:              .\u002Fdocs\u002Fimg\u002Fmaintenance.png                    \"Screen 4\"\n[network]:                  .\u002Fdocs\u002Fimg\u002Fnetwork.png                        \"Screen 5\"\n[settings]:                 .\u002Fdocs\u002Fimg\u002Fsettings.png                       \"Screen 6\"\n[showcase]:                 .\u002Fdocs\u002Fimg\u002Fshowcase.gif                       \"Screen 6\"\n[sync_hub]:                 .\u002Fdocs\u002Fimg\u002Fsync_hub.png                       \"Screen 8\"\n[notification_center]:      .\u002Fdocs\u002Fimg\u002Fnotification_center.png            \"Screen 8\"\n[sent_reports_text]:        .\u002Fdocs\u002Fimg\u002Fsent_reports_text.png              \"Screen 8\"\n[device_nmap]:              .\u002Fdocs\u002Fimg\u002Fdevice_tools.png                    \"Screen 9\"\n[report1]:                  .\u002Fdocs\u002Fimg\u002Freport_sample.png                  \"Report sample 1\"\n[main_dark]:                \u002Fdocs\u002Fimg\u002F1_devices_dark.jpg                  \"Main screen dark\"\n[maintain_dark]:            \u002Fdocs\u002Fimg\u002F5_maintain.jpg                      \"Maintain screen dark\"\n[follow_star]:              \u002Fdocs\u002Fimg\u002FFollow_Releases_and_Star.gif        \"Follow and Star\"\n","NetAlertX 是一个提供集中网络可见性和持续资产发现的工具。它能够监控设备、检测变更，并在分布式网络中保持警觉，通过实时维护连接设备的清单来识别影子IT和未经授权的硬件，确保合规性的同时自动化工作流程。基于Python开发，支持Docker快速部署，NetAlertX旨在填补简单网络扫描与复杂SIEM工具之间的空白，为用户提供可操作的洞察而无需额外负担。适用于需要增强网络安全管理、资产追踪及合规性的企业或组织环境。",2,"2026-06-11 03:35:57","high_star"]