docker

Update ghcr.io/jokob-sk/netalertx Docker tag to v26.1.17

Michi Kofler-Häusler

Michi Kofler-Häusler

— 4 min read
Update ghcr.io/jokob-sk/netalertx Docker tag to v26.1.17
Photo by Sigmund / Unsplash

I upgraded NetAlertX successfully by means of Watchtower Docker container update with dependency update facilitated by Mend's Renovate Bot.

This MR contains the following updates:

Package Update Change
ghcr.io/jokob-sk/netalertx major 25.11.29 → 26.1.17

Release Notes

jokob-sk/NetAlertX (ghcr.io/jokob-sk/netalertx)

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

Compare Source

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 MRs, testing, and feedback continue to make NetAlertX better with every iteration 🙏

See below for more detailed updates.

Screenshots

img

💔 Breaking changes

Sometimes I have to introduce breaking changes

docker-compose.yml updates

To add the GUID and PUID capability we had to add new permissions:

    cap_add:                                        # Add only the necessary capabilities
      - NET_ADMIN                                   # Required for ARP scanning
      - NET_RAW                                     # Required for raw socket operations
      - NET_BIND_SERVICE
      - CHOWN       # 🆕new line
      - SETUID      # 🆕new line
      - SETGID      # 🆕new line

See the updated docker-compose docs for details

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

[!WARNING]

  • ⚠DEPRECATED: The port of the sync nodes for the SYNC plugin will change to the value of the GRAPHQL_PORT setting. Both ports are currently supported, so please update your configuration to point to the new port in the SYNC_hub_url and SYNC_nodes settings.
  • 🔺DEPRECATED: If you have implemented external applications using the OLD API endpoints, please migrate to the NEW API endpoints.

Some OLD endpoints are still present but they will be now removed in upcoming versions.

🆕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 (MRs welcome, but follow guidelines)

What's Changed

New Contributors

Full Changelog: https://github.com/jokob-sk/NetAlertX/compare/v25.11.29...v26.1.17

Read more

Me on Mastodon - This link is here for verification purposes.