github jokob-sk/NetAlertX v24.12.23
v24.12.23 - 🎁New FREEBOX, IPNEIGH, ICMP plugins and better performance

one day ago

This release contains a lot of changes, hopefully for the better πŸ™‚

On the performance improvements, the app can now handle displaying 3000+ devices as I moved to server-side data retrieval (GraphQL - new application port needs to be made available). More work will be necessary to make the whole app performant, but I'll wait for feedback first. If you are interested in improving the performance further, especially by reducing Disk IO, go through the updated Performance improvements documentation - big thanks to @ingoratsdorf for the help here. There is also a new setting to disable Plugin discovery, if you want to speed up the saving and start time further.

On the usability side, I did lots of refactoring on the Devices details page to make the maintenance of it easier and the UI a bit more unified. There is now a better support of Remote network scanning, by using ICMP or NMAPDEV plugins. Read the remote networks docs for details. You can now also create new devices manually if you then for example want to scan them with the ICMP plugin or if you want to add undiscoverable devices with more details (I'll probably remove the UNDIS undiscoverables plugin as a result - reach out if you have feedback!).

There have been some amazing contributions from the community from @KayJay7, @Lucide, @Leicas, Antoine Weill--Duflos (plugins work), @ingoratsdorf (docs, testing), @ytorres (bare-metal install improvements), Максим Π“ΠΎΡ€ΠΏΠΈΠ½Ρ–Ρ‡ (full Ukrainian translation), Anton Garcias, Sylvain Pichon, @Atalanttore, @MacVille, @YoSafeguard, @stan0ne, @mapi68, @gallegonovato, @GitSpoon (translation work)

πŸ™ thanks everyone - I wouldn't be able to maintain all of this just by myself πŸ™

There have been lot's of other changes, so check the details below, especially when it comes to log and API file locations or if you have custom integrations relying on old DB column names.

Screenshots

image image
image image

❗ Known issues:

  • Events and Presence pages are still unoptimized

πŸ’” Breaking changes

Sometimes I have to introduce breaking changes

  • Devices table column name changes to support access via GraphQL - might interfere with your existing integrations
  • If jumping to this version from an older version (3 + months older) please run v24.10.31 before upgrading to this version
  • If running multiple NetAlertX instances on the same URL, make sure GRAPHQL_PORT is unique across all instances
  • If using PRO font awesome icons the location has changed from /app/front/lib/AdminLTE/bower_components/font-awesome to /app/front/lib/font-awesome

🏘️ Community

  • This project received some amazing support from the community in this release, @KayJay7, @Lucide, @Leicas creating and fixing plugins πŸ™

πŸ“šDocs updates

βš™Settings

  • The SYNC_api_token is used in the GraphQL server and renamed to API_TOKEN and moved to the General section ⚠
  • A new NMAPDEV_FAKE_MAC setting to generate MAC addresses from IPs πŸ†•
  • A new DISCOVER_PLUGINS setting to speed up app loading time πŸ†•

πŸ”ŒPlugins

  • New FREEBOX device import plugin by @KayJay7 and @Lucide #799 πŸ™ πŸ†•
  • New IPNEIGH plugin for device scans by the amazing @KayJay7 πŸ™ πŸ†•
  • Fixes to the Omada OMDSDN plugin by the great @Leicas πŸ™ should be fixing #825 #882✨
  • New ICMP plugin for device status checks #723 #891 πŸ†•
  • SMTP: Missing Date filed in email caused issues with some SMTP providers #885 ✨
  • The PHOLUS plugin was removed as the functionality is replaced by AVAHISCAN, NBTSCAN and NSLOOKUP ⚠

πŸ–Ό UI

  • Manually create dummy devices with all details #891 πŸ†•
  • Better Offline/Online status resolution in the Devices listing page preventing Online + Grey background statuses ✨
  • Wake-on-LAN (WOL) moved to the Tools tab ✨
  • Copy details from device moved to the Tools tab ✨
  • Rebuild and refactoring of the Device edit screen ✨
  • Removal of the "Scan device" attribute as it wasn't used anywhere ✨

πŸ’ Core app updates

Internal changes affecting the whole app and usually significant to developers πŸ‘©β€πŸ’»πŸ‘¨β€πŸ’»

  • Bare-metal installation improvements by @ytorres πŸ™βœ¨
  • GraphQL server added to improve application performance πŸ†•
  • Integer names were causing backed restarts #874 ✨
  • Rewrite of the Devices page to support 3000+ devices ✨
  • Vendor names were not automatically updated #889 ✨
  • Hopefully better wal database file management to keep the file size in check✨
  • Move of the API folder from /app/front/api to /app/api ⚠
  • Move of the LOGS folder from /app/front/log to /app/log ⚠
  • Move of the last_results.log from the plugins folders to /app/front/log/plugins/last_result.PLUGPREF.log ⚠
  • SYNC_api_token renamed to API_TOKEN and moved to the General section ⚠

Other Info

πŸ†• - New features ✨ - Fixes & Improvements ⚠ - Possibly breaking changes πŸ§ͺ - Experimental/work in progress

Previous releases:

https://github.com/jokob-sk/NetAlertX/releases

Target release frequency:

  • Monthly

What's Changed

New Contributors

Full Changelog: v24.10.31...v24.12.23

Don't miss a new NetAlertX release

NewReleases is sending notifications on new releases.