Skip to content

NetAlertX

Network Security

A centralized network visibility and asset intelligence framework for homelabs, IT teams, and MSPs that continuously discovers devices, detects changes, and maintains a real-time inventory.

Track releases GitHub Website
Python Latest v26.6.3 · 1d ago Security brief →

Features

  • Continuous discovery of connected devices with multiple scan methods (arp-scan, Pi‑hole imports, DHCP, UNIFI controller, SNMP routers).
  • Real‑time asset intelligence to detect unauthorized hardware, Shadow IT, and IP address drift.
  • Notification gateways supporting over 80 services (Telegram via Apprise, Pushsafer, Pushover, NTFY, etc.).
  • Extensible plugin system enabling custom scanners and integrations in minutes.

Recent releases

View all 8 releases →
Config change
v26.6.3 Breaking risk
Breaking upgrade Auth

Distributed handling, SYNC_BEHAVIOR, plugins, UI & ICMP fixes

Open
v26.5.4 Breaking risk
Breaking changes
  • Removal of OLD API endpoints (https://docs.netalertx.com/API_OLD); migrate to NEW API endpoints (https://docs.netalertx.com/API).
Notable features
  • DEEP_SLEEP support reduces CPU usage by ~50% on low-power hardware.
  • Fritz!Box plugin added via TR-064 protocol.
  • Parent node filter for managing complex network hierarchies.
Full changelog

Hi all :wave:

This release focuses on low-level efficiency and expanding hardware support through some amazing contributions from you, the community.

A major addition in this version is DEEP_SLEEP support (thanks to @legionGer for help), which specifically targets high CPU usage by allowing the system to idle more effectively. For those running on low-power hardware or larger home labs, this should result in a much lighter footprint (~50% less) and better overall system resource management.

The plugin ecosystem is also growing thanks to several PRs. We now have a Fritz!Box plugin (by @sebingel) and a critical fix for the Omada Controller 6.2.x+ (by @xfilo), which had previously broken due to vendor API changes. Grateful to see the community stepping in to maintain these integrations. :muscle:

I’ve also addressed some annoyances. For instance, sorting in the Network view is now numerical instead of alphabetical, so IP addresses now appear in the correct order. I also fixed a bug where DBCLNP wasn’t cleaning up AppEvents and Plugins_History, which is critical for keeping the SQLite database performant. Other improvements include better filtering logic for flapping statuses and a new Parent node filter to help manage more complex network hierarchies.

Thanks to everyone who contributed code, fixes, and translations for this release. See more details below.

Screenshots

💔 Breaking changes

Sometimes I have to introduce breaking changes

[!WARNING]

🆕New capabilities

  • FRITZBOX plugin by @sebingel 🙏 #1592
  • Added the option to display a Parent node filter #1611
  • DEEP_SLEEP support slashing CPU use by @legionGer #1555

✨Fixes and Improvements

  • DBCLNP failed to clean AppEvents and Plugins_History
  • Flapping status didn't take per-device Force status configuration into account #1602
  • The Events on a device were occasionally not filtered correctly #1607
  • The ordering by IP in the Network view was changed from alphabetical to numerical #1606
  • Expanded the coverage of the device/<mac>/update-column API endpoint #1598
  • OMDSDNOPENAPI didn't support the Controller 6.2.x+ versions #1595 - fix thanks to @xfilo 🙏
  • Column filters respect the order of the setting and CSS tweaks for a more compact layout #1616
  • Sync node value is back-ported if missing #1609
  • Spelling fixes by @MarkMuri-SW
  • Czech translation improvements by @IntExCZ

🔝 Current priorities

  • High priority: Settings, Workflows and Plugins core improvements
  • Low priority: UI (PRs welcome, but follow guidelines)

🐞 Known issues

If you have any debug info/suggestions regarding the above, please open a separate issue, thanks! 🤍

What's Changed

  • feat(plugins): Add Fritz!Box device scanner plugin via TR-064 protocol by @sebingel in https://github.com/netalertx/NetAlertX/pull/1592
  • Fix set-alias endpoint: return HTTP 200 with normalized error key on failure by @Copilot in https://github.com/netalertx/NetAlertX/pull/1600
  • Fix set_alias 404 handling: simplify failure check to prevent silent regression by @jokob-sk in https://github.com/netalertx/NetAlertX/pull/1599
  • sync by @jokob-sk in https://github.com/netalertx/NetAlertX/pull/1603
  • Next release by @jokob-sk in https://github.com/netalertx/NetAlertX/pull/1604
  • PLG: Enhance IP sorting in device table for correct numeric order #1606 by @jokob-sk in https://github.com/netalertx/NetAlertX/pull/1608
  • FIX: Add 'No Data' message for empty plugin tabs and enhance event da… by @jokob-sk in https://github.com/netalertx/NetAlertX/pull/1610
  • PLG: Implement selective recording for Plugins_History to prevent unb… by @jokob-sk in https://github.com/netalertx/NetAlertX/pull/1612
  • sync by @jokob-sk in https://github.com/netalertx/NetAlertX/pull/1614
  • Next release by @jokob-sk in https://github.com/netalertx/NetAlertX/pull/1615
  • ordering support for filters added #1616 by @jokob-sk in https://github.com/netalertx/NetAlertX/pull/1617
  • sync by @jokob-sk in https://github.com/netalertx/NetAlertX/pull/1619
  • Merge pull request #1619 from netalertx/main by @jokob-sk in https://github.com/netalertx/NetAlertX/pull/1620
  • OMDSDNOPENAPI - Handle removal of v1 clients endpoint in Omada Controller >= 6.2.0.0 by @xfilo in https://github.com/netalertx/NetAlertX/pull/1622
  • sync by @jokob-sk in https://github.com/netalertx/NetAlertX/pull/1624
  • Next release: Deep sleep by @jokob-sk in https://github.com/netalertx/NetAlertX/pull/1625

New Contributors

  • @Copilot made their first contribution in https://github.com/netalertx/NetAlertX/pull/1600

Full Changelog: https://github.com/netalertx/NetAlertX/compare/v26.4.6...v26.5.4

View release on GitHub
v26.4.6 Breaking risk
Breaking changes
  • Old API endpoints removed; external applications must migrate to new endpoints.
  • Notification field names standardized, breaking existing JSON structures for down_devices and down_reconnected sections.
Notable features
  • Added Text notification template override settings (NTFPRCS_TEXT_) for custom notification formats.
  • Refactored database schema to accelerate GraphQL queries and improve performance of Event and Plugin list retrieval.
  • Introduced over 500 new test cases and a DB refactor that lowered maintenance effort.
View release on GitHub
v26.3.15 Bug fix
Breaking changes
  • Old API endpoints will be removed in next release
  • Notification payload field names will be standardized across sections
View release on GitHub
v26.3.7 New feature
Notable features
  • Sleeping device state
  • Flapping/Unstable device detection
  • VLAN network topology
View release on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

About

Stars
6,513
Forks
409
Languages
Python JavaScript PHP
View on GitHub Homepage Documentation

Install & Platforms

Install via
docker

Community & Support

Discord

Similar tools

NetXMS
OpenRemote
Nebula
neodb
slskd

Beta — feedback welcome: [email protected]