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.31before upgrading to this version - If running multiple NetAlertX instances on the same URL, make sure
GRAPHQL_PORTis unique across all instances - If using PRO font awesome icons the location has changed from
/app/front/lib/AdminLTE/bower_components/font-awesometo/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_tokenis used in the GraphQL server and renamed toAPI_TOKENand moved to the General section β - A new
NMAPDEV_FAKE_MACsetting to generate MAC addresses from IPs π - A new
DISCOVER_PLUGINSsetting to speed up app loading time π
πPlugins
- New
FREEBOXdevice import plugin by @KayJay7 and @Lucide #799 π π - New
IPNEIGHplugin for device scans by the amazing @KayJay7 π π - Fixes to the Omada
OMDSDNplugin by the great @Leicas π should be fixing #825 #882β¨ - New
ICMPplugin for device status checks #723 #891 π SMTP: MissingDatefiled in email caused issues with some SMTP providers #885 β¨- The
PHOLUSplugin was removed as the functionality is replaced byAVAHISCAN,NBTSCANandNSLOOKUPβ
πΌ 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
waldatabase file management to keep the file size in check⨠- Move of the API folder from
/app/front/apito/app/apiβ - Move of the LOGS folder from
/app/front/logto/app/logβ - Move of the
last_results.logfrom the plugins folders to/app/front/log/plugins/last_result.PLUGPREF.logβ SYNC_api_tokenrenamed toAPI_TOKENand 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 neighcommand 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