# netalertx/netalertx

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/netalertx-netalertx).**

6,604 stars · 417 forks · Python · GPL-3.0

## Links

- GitHub: https://github.com/netalertx/NetAlertX
- Homepage: https://netalertx.com
- awesome-repositories: https://awesome-repositories.com/repository/netalertx-netalertx.md

## Topics

`arp-scan` `asset-management` `dcim` `ipam` `network-analysis` `network-automation` `network-monitoring` `network-security` `networking` `security` `selfhosted` `sysadmin` `wifi-network` `wifi-security`

## Description

NetAlertX is a distributed network scanner and asset discovery tool designed to identify connected devices and track unauthorized hardware. It aggregates discovery results from multiple remote monitoring nodes into a single centralized inventory hub to provide unified network visibility.

The project distinguishes itself by integrating as a bridge to MQTT brokers for smart home automation and providing a dedicated interface for AI agents to query system data. It employs multi-protocol identity resolution using DNS, mDNS, and NetBIOS to identify hardware and generates synthetic identifiers to ensure inventory persistence for devices lacking standard network IDs.

The system covers a broad range of capabilities, including real-time device status monitoring and event-driven notifications via webhooks and email. It features a plugin framework for extending discovery and automation, as well as diagnostic tools for remote packet scanning and traceroute. Visual monitoring is handled through customizable dashboards and self-healing wallboards.

## Tags

### DevOps & Infrastructure

- [Hub-and-Spoke Agent Deployment](https://awesome-repositories.com/f/devops-infrastructure/distributed-deployment/hub-and-spoke-agent-deployment.md) — Aggregates discovery data from distributed remote monitoring nodes into a single central hub for unified visibility.
- [Inventory Data Synchronization](https://awesome-repositories.com/f/devops-infrastructure/inventory-data-synchronization.md) — Transfers network discovery data between remote collectors and a central server using direct uploads or retrieval. ([source](https://docs.netalertx.com/ADVISORY_MULTI_SITE_MONITORING))
- [Network Control APIs](https://awesome-repositories.com/f/devops-infrastructure/network-control-apis.md) — Offers authenticated web APIs to programmatically query and control discovered devices, events, and network metrics. ([source](https://docs.netalertx.com/API))
- [Network Webhooks](https://awesome-repositories.com/f/devops-infrastructure/network-webhooks.md) — Provides mechanisms to trigger external events and workflows via webhooks based on network state changes.

### System Administration & Monitoring

- [Network Discovery Scanners](https://awesome-repositories.com/f/system-administration-monitoring/network-discovery-scanners.md) — Aggregates discovery results from multiple remote monitoring nodes into a centralized inventory hub for network visibility.
- [Event-Driven Notification Triggers](https://awesome-repositories.com/f/system-administration-monitoring/alert-notification-systems/event-driven-notification-triggers.md) — Dispatches real-time alerts and webhooks in response to changes in device status and network event logs.
- [Automated Asset Governance](https://awesome-repositories.com/f/system-administration-monitoring/automated-asset-governance.md) — Automatically categorizes devices, assigns network nodes, and groups hardware by vendor using automated rules. ([source](https://cdn.jsdelivr.net/gh/netalertx/netalertx@main/README.md))
- [Distributed Status Aggregators](https://awesome-repositories.com/f/system-administration-monitoring/distributed-status-aggregators.md) — Provides unified oversight by aggregating health and discovery data from distributed remote monitoring instances.
- [Multi-Site Monitoring](https://awesome-repositories.com/f/system-administration-monitoring/health-monitoring/site-health-monitors/multi-site-monitoring.md) — Collects asset data from distributed remote sites via sync nodes to maintain a unified inventory view. ([source](https://cdn.jsdelivr.net/gh/netalertx/netalertx@main/README.md))
- [Network Connectivity Monitoring](https://awesome-repositories.com/f/system-administration-monitoring/network-connectivity-monitoring.md) — Tracks the real-time online or offline status of devices to detect unauthorized hardware joining the network.
- [Real-Time Monitoring Dashboards](https://awesome-repositories.com/f/system-administration-monitoring/real-time-monitoring-dashboards.md) — Provides a visual interface for tracking device online status and overall network health in real-time.
- [Custom Notification Triggers](https://awesome-repositories.com/f/system-administration-monitoring/alert-notification-systems/event-driven-notification-triggers/custom-notification-triggers.md) — Triggers custom alerts to external platforms when specific monitored network conditions are met. ([source](https://docs.netalertx.com/PLUGINS_DEV))
- [Device Connectivity Tracking](https://awesome-repositories.com/f/system-administration-monitoring/client-device-tracking/device-connectivity-tracking.md) — Monitors network changes and records online/offline status transitions for assets over time. ([source](https://netalertx.com/](https://netalertx.com/))
- [Device State Monitors](https://awesome-repositories.com/f/system-administration-monitoring/device-state-monitors.md) — Tracks whether discovered and manual assets are online or offline using periodic ping requests. ([source](https://docs.netalertx.com/REMOTE_NETWORKS))
- [Network Health Visualizations](https://awesome-repositories.com/f/system-administration-monitoring/network-health-visualizations.md) — Displays real-time asset visibility and network health through dedicated dashboards and monitoring wallboards. ([source](https://cdn.jsdelivr.net/gh/netalertx/netalertx@main/README.md))
- [Network Task Automation](https://awesome-repositories.com/f/system-administration-monitoring/network-task-automation.md) — Executes sequences of actions based on triggers and logical conditions to handle network discovery and cleanup. ([source](https://docs.netalertx.com/WORKFLOWS))
- [Notification Dispatchers](https://awesome-repositories.com/f/system-administration-monitoring/notification-dispatchers.md) — Implements a dispatching system that routes network alerts to various external communication platforms. ([source](https://docs.netalertx.com/PLUGINS))
- [Observability Data Exporters](https://awesome-repositories.com/f/system-administration-monitoring/observability-tracing/batch-export-utilities/trace-exporters/observability-data-exporters.md) — Streams device changes and network metrics to external automation platforms and webhooks for operational workflows. ([source](https://cdn.jsdelivr.net/gh/netalertx/netalertx@main/README.md))

### Business & Productivity Software

- [Device Presence Alerts](https://awesome-repositories.com/f/business-productivity-software/device-presence-alerts.md) — Sends real-time alerts when new devices join or existing devices leave the network to maintain asset visibility. ([source](https://docs.netalertx.com/))
- [Asset Categorization Rules](https://awesome-repositories.com/f/business-productivity-software/programmatic-rule-engines/categorization-rule-execution/asset-categorization-rules.md) — Automatically groups and labels discovered devices using logical conditions and vendor-specific matching rules.

### Data & Databases

- [Distributed Data Synchronization Systems](https://awesome-repositories.com/f/data-databases/distributed-data-synchronization-systems.md) — Maintains a unified network inventory by synchronizing discovery results from distributed remote monitoring nodes. ([source](https://docs.netalertx.com/API))
- [Infrastructure Data Imports](https://awesome-repositories.com/f/data-databases/external-data-integrations/third-party-data-connectors/infrastructure-data-imports.md) — Imports device lists and network data from third-party routers and API endpoints to centralize inventory. ([source](https://docs.netalertx.com/PLUGINS))
- [Data Exposure](https://awesome-repositories.com/f/data-databases/data-modification-apis/data-exposure.md) — Exposes system state and metrics via standardized REST API endpoints for external AI agents and automation tools.
- [Data Mapping](https://awesome-repositories.com/f/data-databases/search-suggestions/data-mapping.md) — Maps data from third-party systems and network protocols into centralized device and scan tables. ([source](https://docs.netalertx.com/PLUGINS_DEV))

### Networking & Communication

- [Event Notifications](https://awesome-repositories.com/f/networking-communication/event-notifications.md) — Dispatches notifications to external services whenever network changes or specific device events occur. ([source](https://cdn.jsdelivr.net/gh/netalertx/netalertx@main/README.md))
- [Multi-Protocol Identity Resolution](https://awesome-repositories.com/f/networking-communication/multi-protocol-identity-resolution.md) — Identifies hardware by sequentially querying DNS, mDNS, and NetBIOS protocols to resolve network addresses.
- [Network Device Discovery](https://awesome-repositories.com/f/networking-communication/network-device-discovery.md) — Scans local networks using ARP and DHCP to identify and categorize connected hardware devices.
- [Network Environment Scanning](https://awesome-repositories.com/f/networking-communication/network-environment-scanning.md) — Provides active network discovery to identify connected devices and analyze performance metrics within local network environments. ([source](https://docs.netalertx.com/PLUGINS))
- [MQTT Messaging Integrations](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/communication-apis/mqtt-messaging-integrations.md) — Publishes device status and network statistics to MQTT brokers for integration with smart home controllers. ([source](https://docs.netalertx.com/HOME_ASSISTANT))
- [Network Device Arrival Notifiers](https://awesome-repositories.com/f/networking-communication/device-notification-bridges/network-device-arrival-notifiers.md) — Sends alerts via webhooks and email when new or existing devices join or leave the network.
- [Network Diagnostics](https://awesome-repositories.com/f/networking-communication/network-diagnostics.md) — Offers programmable tools for running remote connectivity tests and packet scans to troubleshoot network issues.

### Artificial Intelligence & ML

- [AI Assistant Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-assistant-integrations.md) — Provides specialized interfaces that allow AI agents to query and interact with network monitoring data. ([source](https://docs.netalertx.com/API))

### Development Tools & Productivity

- [Network Diagnostic Interfaces](https://awesome-repositories.com/f/development-tools-productivity/remote-diagnostic-consoles/network-diagnostic-interfaces.md) — Executes remote network utilities like traceroute and packet scans through a programmable interface for troubleshooting. ([source](https://docs.netalertx.com/API))
- [External Workflow Triggers](https://awesome-repositories.com/f/development-tools-productivity/workflow-automation-triggers/external-workflow-triggers.md) — Pushes network events to external automation platforms via webhooks to trigger downstream operational workflows. ([source](https://docs.netalertx.com/WEBHOOK_N8N))

### Hardware & IoT

- [Persistence Identifiers](https://awesome-repositories.com/f/hardware-iot/hardware-device-identification/unique-identifiers/persistence-identifiers.md) — Generates synthetic tracking keys for devices without standard IDs to ensure consistent inventory tracking over time. ([source](https://docs.netalertx.com/REMOTE_NETWORKS))

### Software Engineering & Architecture

- [Plugin Development Frameworks](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/extensibility/third-party-plugins/plugin-development-frameworks.md) — Implements a framework for integrating third-party scripts to expand device discovery and custom automation. ([source](https://docs.netalertx.com/PLUGINS))
- [Plugin-Based Logic Extensions](https://awesome-repositories.com/f/software-engineering-architecture/plugin-based-logic-extensions.md) — Uses a plugin-based model to execute third-party scripts and binaries for extending discovery and monitoring.