v24.12.23 - ๐New FREEBOX, IPNEIGH, ICMP plugins and better performance
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
โ 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
- Synology NAS setup guide ๐
- Remote networks docs ๐
- More Performance improvements suggestions by @ingoratsdorf by storing temporary file sin memory ๐โจ
โSettings
- The
SYNC_api_token
is used in the GraphQL server and renamed toAPI_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
: MissingDate
filed in email caused issues with some SMTP providers #885 โจ- The
PHOLUS
plugin was removed as the functionality is replaced byAVAHISCAN
,NBTSCAN
andNSLOOKUP
โ
๐ผ 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 toAPI_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
- Add IPNEIGH plugin for IPv4/6 discovery using the
ip neigh
command by @KayJay7 in #896 - Feature/ipneigh by @jokob-sk in #900
- Fix for issue with OMADA plyging with ip detection sometimes breaking. by @Leicas in #894
- Added FREEBOX plugin by @KayJay7 in #901
- Update start.debian.sh by @ytorres in #911
- Update install_dependencies.debian.sh by @ytorres in #910
- Fix typo by @ytorres in #912
New Contributors
- @KayJay7 made their first contribution in #896
- @Leicas made their first contribution in #894
- @ytorres made their first contribution in #911
Full Changelog: v24.10.31...v24.12.23