netalertx/NetAlertX v26.1.17

v26.1.17 - 🔽 AdGuard Integration, Deployment Flexibility & MQTT Enhancements

on GitHub

Hey y'all 👋 ,

This release has a strong mix of new capabilities and long-requested fixes. Big thanks to continuous and new contributors.

The SNMP plugin now supports Fortinet / FortiGate devices, and the ICMP plugin now supports fping for faster scans. High-speed networks benefit from a new opt-in native binary for INTRSPD, and MQTT users can now receive full, rich notification payloads (matching webhook behavior) for events like new, down, and reconnected devices. This release also introduces AdGuard Home integration via a new import plugin, expands deployment flexibility with the return of PUID/GUID environment variables, and improves overall discovery accuracy.

Reverse-proxy setups are now more robust thanks to the new BACKEND_API_URL setting and improved documentation. MQTT now correctly supports anonymous connections, a new UI_LOCALE setting addresses browser-specific date quirks, and fake MAC addresses are clearly identifiable using the FA:CE: prefix.

As always, huge thanks to the community contributors who helped push this release forward — your PRs, testing, and feedback continue to make NetAlertX better with every iteration 🙏

See below for more detailed updates.

Screenshots

💔 Breaking changes

Sometimes I have to introduce breaking changes

• See Past breaking Changes.

For reverse proxies use the BACKEND_API_URL setting to point to your backend port

If SMTP not working as expected please navigate to Settings and do the following:

1. Clear the existing SMTP_PASS in the UI
2. Enter your SMTP_PASS
3. Click Save

🆕New capabilities

• SNMPDSC now supports Fortinet/Fortigate systems #1324
• INTRSPD now supports opt-in native binary for high-sped internet connections (see docs on how to enable) - thanks to @amir0ff 🙏
• MQTT now supports sending of full notification messages #1339
• A new AdGuard import plugin ADGUARDIMP #1341
• Re-introduction of PUID and GUID environmental variables for more deployment options - thanks to @adamoutler 🙏
• The ICMP plugin now supports fping via the ICMP_MODE setting #1331

✨Fixes and Improvements

• For reverse proxies use the BACKEND_API_URL setting to point to your backend port
• More robust error handling in the Network topology view #1323 #1308
• More robust handling of date-time stamps YYYY.DD.MM #1312
• Backups of app.conf files created in wrong directory during settings save #1311
• APP_CONF_OVERRIDE was not applied #1328
• MQTT allows for anonymous connections #1358
• A new UI_LOCALE setting to control date display as Chrome and Firefox behave differently when using the TZ #1335
• Fake MAC addresses will from now start with FA:CE: to make it easily distinguishable and detectable #1344
• Better Reverse Proxy support and Authentik docs by @luckylinux 🙏
• New NEWDEV_NAME_CLEANUP_REGEX defaults to cleanup .home.arpa names #1383

🔝 Current priorities

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

What's Changed

• Fix typo in warning message for read-only mode by @mmomjian in #1317
• Change copy command to install with permissions by @adamoutler in #1332
• Remove dev branch from docker compose file by @KihtrakRaknas in #1333
• Fix pr 1309: Add OpenAPI Tools and MCP Server Bridge by @jokob-sk in #1326
• Add script to generate synthetic device inventory CSV by @adamoutler in #1338
• Devcontainer-devices by @adamoutler in #1340
• Allow other users (Non-Synology) by @adamoutler in #1363
• Improving mount diagnostics by @adamoutler in #1364
• Hybrid Speedtest implementation (Python-First with Native Opt-in) by @amir0ff in #1370
• Feature: Passive PUID/PGID Support & Startup Sequence Refactor by @adamoutler in #1381
• PUId fixes by @adamoutler in #1387
• Enable Root PUID; Add AUFS filesystem capability warnings and documentation by @adamoutler in #1393
• Fix Saving Changes in Devices Page. by @luckylinux in #1395
• [reverse proxy] Use getApiBase() to get GraphQL Endpoint for events by @luckylinux in #1397
• [reverse proxy] Use getApiBase() to get GraphQL Endpoint for front/deviceDetailsTools.php. by @luckylinux in #1396
• [reverse proxy] Use getApiBase() to get GraphQL Endpoint for System Information about Network by @luckylinux in #1398
• Add selenium to devcontainer by @adamoutler in #1399
• fix: root access PHP & Nginx by @adamoutler in #1400
• Add caddy and authentik sso documentation by @luckylinux in #1415

New Contributors

• @mmomjian made their first contribution in #1317
• @amir0ff made their first contribution in #1370
• @luckylinux made their first contribution in #1395

Full Changelog: v25.11.29...v26.1.17