Skip to content

v24.12.23 - ๐ŸŽNew FREEBOX, IPNEIGH, ICMP plugins and better performance

Compare
Choose a tag to compare
@jokob-sk jokob-sk released this 22 Dec 23:41
· 134 commits to main since this release
febc26b

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