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