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 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

• 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

v24.10.31 - 🔌 Better Plugins UI and Auto deletion of Offline devices

In this release @johnwang16 helped solve a couple of issues, for example he fixed an issue where the presence would be empty for always-on devices 🙏 Another contributor, @richtj999 helped write up a use case for the Sync Hub. Thanks guys and everyone else that contributed, like the always speedy translation team @mapi68 , @realgooseman , @GitSpoon , @YoSafeguard , @wial88 , @ytorres ... Also @Stationary-1 helped me to debug a couple of issues, including 2 related to the INTRNSPD plugin, so it's more robust in reporting your internet speeds.

Other improvements include adding a Source Plugin column, so that you see which plugin detected the device, a rebuild of the Plugins view with data tables so you can filter, sort and some other quality of life improvements, such disabling Alert Events on a Device won't prevent New Device notifications or a new setting HRS_TO_KEEP_OFFDEV to delete offline devices after a certain time. Check out more details below.

Thanks everyone for the help!

Screenshots

💔 Breaking changes

Sometimes I have to introduce breaking changes

• If you used "UI_dark_mode":"True" in your docker-compose.yml you need to replace it with "UI_theme":"Dark" and you might need to rebuild your container.

📚Docs updates

• Notes On WiFi Extenders #852
• Sync Hub Use case by @richtj999 🙏#788

⚙Settings

• A new setting HRS_TO_KEEP_OFFDEV to delete offline devices after a certain time #865 🆕
• Sync: Generate token/key buttons as they are also used for Homepage authentication #838 🆕

🔌Plugins

• The INTRNSPD plugin didn't display values over 100 and was frequently failing #854 ✨
• The ROGUEDHCP plugin didn't allow for custom timeout configuration #851 ✨
• The UNFINMP plugin may have imported devices with incorrect MAC addresses causing restarts #848 ✨

🖼 UI

• Auto dark theme selection ( UI_dark_mode -> UI_theme) depending on system settings by @johnwang16 🙏🆕
• Rebuild the Plugins section with data tables allowing for filtering, sorting 🆕
• Preventing infinite recursion on the Network diagram #857 ✨
• Clickable IPs in the devices listing table #856 🆕
• Colors explanation in the presence page 🆕
• Custom values didn't show up in the Location dropdown #862 ✨
• @cvc90 fixed an issue causing problems with reverse proxies on the Notifications page ✨

💠Core app updates

Internal changes affecting the whole app and usually significant to developers 👩‍💻👨‍💻

• Empty presence of always on devices fixed by @johnwang16 🙏#814
• A new Source Plugin column on the Devices tables so you can quickly see where the device was discovered 🆕
• Disabling Alert Events on a Device won't prevent New Device notifications #262 ✨

Other Info

🆕 - New features	✨ - Fixes & Improvements	⚠ - Possibly breaking changes	🧪 - Experimental/work in progress

What's Changed

• Changed the "absolute URL" target to "relative URL" in userNotifications.php for viewing reports by @cvc90 in #837
• Fix network tree offline color for SVG icons by @johnwang16 in #850
• Allow auto light/dark mode matching user OS setting by @johnwang16 in #853
• Add events for imported devs by @johnwang16 in #855

New Contributors

• @johnwang16 made their first contribution in #850

Full Changelog: v24.10.12...v24.10.31

v24.10.12 - Better name discovery, MQTT and UI improvements ✨

Hey everyone 👋

This release contains stability improvements, bug fixes and a couple of new features. There is a new plugin for better device name resolution (AVAHISCAN) that helps getting more accurate device names especially for Apple devices. Thanks @stanelie for testing and the patience 🙂

Contributors helped me make the MQTT plugin better to support EMQX and to display time values in the Home Assistant attributes better. Thanks to @ingoratsdorf , @NightMean , @Jozko568 🙏

There are a couple of UI improvements in the Settings section on mobile, easier selection of Plugins, separately showing offline and down devices in the presence chart.

I've updated a few docs and also written up how to improve the performance on how to keep the app chugging along without issues 🚂

As always, thanks to everyone helping with translations (@ytorres, @Noschvie, @mapi68, @YoSafeguard, @gallegonovato), answering discussions (@leiweibau, @FlyingToto), testing (@corasaniti) and contributing (@RincewindX) in any way! 💪

Make sure you refresh your browser cache (usually shift + reload button) - and click the 🔄 refresh button in the top right corner.

🏘️ Community

• Big thanks to @corasaniti for testing the dev branch 🙏

📚Docs updates

• How to improve the performance 🆕
• Improvement to the developer environment setup docs ✨
• Improving the clarity of the Subnets docs ✨

⚙Settings

• MQTT_topic_root allowing to specify a custom topic, e.g. netalertx instead of the default system-sensors ✨
• NEWDEV_ignored_IPs and NEWDEV_ignored_MACs where not applied on new device discovery #836

🔌Plugins

• AVAHISCAN for mDNS device name lookup to retrieve better names especially for Apple devices #815 🆕
• MQTT improvements to support EMQX by @ingoratsdorf ✨
• MQTT improvements by @NightMean and @Jozko568, such as better diacritics support ✨
• UNIFIMP didn't handle new devices correctly if a port value was passed to the app #833 ✨
• UNIFIMP is now normalizing strings so that diacritics are normalized and not skipped caméra -> camera ✨
• MIKROTIK didn't pass IPs correctly, so they were missing in the devices tables #835 ✨

🖼 UI

• CSV export didn't handle quotes and new lines in the comments field #808 ✨
• Presence over time chart shows Down devices separately from Offline devices #816 🆕
• Settings Mobile UI improvements to show description in pop-up and full-width input area ✨
• Gradual replacement of the click+select setting component with a drop-down and pill component 🆕
• Removal of DB backup functionality (usually handled externally) in the Maintenance section for easier code maintenance ✨

🆕 - 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

• fixes to MQTT publisher by @ingoratsdorf in #810
• Update MQTT to send model as device name by @NightMean in #820
• Update DEBUG_TIPS.md by @RincewindX in #827

New Contributors

• @NightMean made their first contribution in #820
• @RincewindX made their first contribution in #827

Full Changelog: v24.9.26...v24.10.12

v24.9.26 - Auto-Clearing of the 🆕 NEW Device flag, Settings and Sync hub improvements

This release introduces a handy new feature with the CLEAR_NEW_FLAG setting, which automatically unflags devices as "NEW" after a set amount of time following detection. This should streamline device management by reducing the manual effort needed to track device statuses. Alongside this, there are various plugin and UI improvements, ensuring smoother operation and an overall better user experience. As always, make sure to refresh your browser cache, and a big thanks to the contributors for their hard work, be it by contributing in discussions, with code, or translations!

Screenshots

🏘️ Community

• An interesting discussion between @FlyingToto and @rludo2 on how to handle different WANs
• Thanks to the translation contributions of @gallegonovato ✨
• Thank you to people that reported bugs and helped test the netalertx-dev image: @thefunkygibbon, @Dan-Sun, @franbri, @The1Waterman, @itsmemac, @BambamNZ, @richtj999 🙏

📚Docs updates

• Better SYNC plugin docs describing the 3 available modes. ✨
• Updates to the Plugins development guide ✨

⚙Settings

• A new CLEAR_NEW_FLAG setting to auto-un-flag the devices as NEW after a predetermined time after detection #795 🆕
• Display of an overlay for Settings overridden via a docker-compose variable so that users are not confused where the values are coming from 🆕

🔌Plugins

• SYNC plugin improvements allowing you to PULL data from nodes #788 ✨
• The SETPWD plugin wasn't saving the password in the correct format #793 ✨
• UNDIS plugin wasn't generating a fake MAC address preventing these devices to be used in the Network tree map #807 ✨

🖼 UI

• Icon preview for the NEWDEV_dev_Icon setting #789 🆕
• Cleanup of some invalid icon values that displayed incorrectly in the Icons dropdown #802 ✨
• Misc UI fixes by @ingoratsdorf ✨

💠Core app updates

Internal changes affecting the whole app and usually significant to developers 👩‍💻👨‍💻

• Better support for reverse proxies by @alnviana 🆕
• New Settings capabilities to define onChange events and customParams HTML attributes 🆕
• New span Setting UI component 🆕
• Sanitizing input values to prevent errors on single-quotes ' in device text fields #805 ✨

Other Info

🆕 - New features	✨ - Fixes & Improvements	⚠ - Possibly breaking changes	🧪 - Experimental/work in progress

What's Changed

• Fixes to CSS and scripts not loading properly by @ingoratsdorf in #798
• Fixes to work using a reverse proxy by @alnviana in #801

New Contributors

• @alnviana made their first contribution in #801

Full Changelog: v24.9.12...v24.9.26

v24.9.12 - 📣Native Telegram, Mikrotik support, Discord server, Settings set via ENV variables 🧪

This release is packed with amazing features, improvements, and contributions from our fantastic community. A special shoutout to everyone who helped test, refine, and push the boundaries of what we’re building together. Your feedback and dedication make every release better, and I couldn’t do it without you. I hope you enjoy these updates! 🎉

🏘️ Community

• A special thanks to @corasaniti to help me deliver you a less buggy release by testing the dev branch 🙏✨
• A new discord server 🆕

⚙Settings

• Cleanup of list item manipulation buttons to improve the UI ✨
• Experimental docker-compose override support with ENV variables #687 🧪🆕

🔌Plugins

• A native Telegram publisher by @doctorixx 🙏 🆕
• The UNIFI plugin now auto-generates the network topology map and passes the device type 🆕
• A new MIKROTIK MTSCAN plugin by amazing @lookflying and @elraro🙏 🆕
• Improvements to the OMADA SDN plugin by @FlyingToto ✨
• SSL support for the MQTT plugin by @adebrouvier ✨
• Fix for MQTT device tracker adding quotes to payload and Protocol selection, which can be v3 or v5 by @ingoratsdorf 🙏 ✨

🖼 UI

• Polish, French, Russian, German, Spanish, Italian, Chinese, and Norwegian translation improvements by the community (@ozeliurs, @a74451, @GoldBull3t, @blomusti, @mapi68, @gallegonovato, @YoSafeguard, @ternium1, @GitSpoon, @serega404, @ptsa, @Atalanttore, @Ramonnote )🙏✨
• Cache expiration and first-load improvements ✨
• Notification about the app being updated to prompt browser cache refresh based on the VERSION setting 🆕
• Moved the remaining settings from Maintenance (e.g. displayed columns) into Settings -> Core -> UI Settings ✨

💠Core app updates

Internal changes affecting the whole app and usually significant to developers 👩‍💻👨‍💻

• Bare metal installation fixes #753 ✨
• Some icons and device types are auto-assigned vendor information when a device is discovered 🆕
• 4 More Helper Values that can be used to pass data from plugins to the Core app 🆕
• The HRS_TO_KEEP_NEWDEV setting wasn't applied correctly causing new devices to be always deleted #777 ✨

Other Info

🆕 - New features	✨ - Fixes & Improvements	⚠ - Possibly breaking changes	🧪 - Experimental/work in progress

Screenshots

v24.7.18 - TP-Link Omada Support🧪, NetBIOS scan, MQTT📡, UI Enhancements 🚀

Hey everyone 👋

FlyingToto created an amazing new experimental TP-Link Omada plugin 🧪, enabling auto-network topology creation 🌐. Additional highlights include a granular NEWDEV_NAME_CLEANUP_REGEX setting 🔍, cache expiration improvements ⏲️, and the ability to specify devices sent to MQTT 📡.

UI updates improve device status visibility 🟢🔴, add some customization to tiles 🧩, and sortable columns 📊 in the Network view.

Core updates add new fields for network tree generation 🌳, plugin transformers 🔧, and settings page refactoring 🛠️. Refresh your browser cache 🔄 after upgrade.

If you are developer, check out the new 15-minute plugin development video 🎥

🎥Watch the video

Make sure you refresh your browser cache (usually shift + reload button) - and click the 🔄 refresh button in the top right corner.

Screenshots

💔 Breaking changes

Sometimes I have to introduce breaking changes

• Removed NEWDEV_LESS_NAME_CLEANUP and replaced with a more granular NEWDEV_NAME_CLEANUP_REGEX setting

📚Docs updates

• Video on how to 🎥develop a plugin in 15min (🆕)

⚙Settings

• Cache expiration improvements #698 (✨)
• A new NEWDEV_NAME_CLEANUP_REGEX setting so you can specify how newly discovered device names are handled #725 (🆕)
• A MQTT_DEVICES_SQL setting if you want to specify which devices are sent to MQTT #732 (🆕)

🔌Plugins

• (Experimental🧪) OMADA TP-Link import support including auto-network topology creation by @FlyingToto #708 (🆕)
• The MQTT / Home Assitant integration provides a device_tracker sensor with attributes #703 (🆕)
• Some default Plugins couldn't be unloaded #726 (✨)
• Better pfSense / SNMP support with better docs #718 (✨)

🖼 UI

• The device status now shows colors and icons, so even visually impaired users can easily distinguish statuses #706 (🆕)
• You can now select which tiles in the Devices section are shown (+ All, Offline tiles added) #705 (🆕)
• Sortable columns in the Network page #713 (🆕)
• Improved Search filtering (✨)
• Improved Maintenance -> Logs section (🆕)
• Paste to import CSV in Maintenance (🆕)

💠Core app updates

Internal changes affecting the whole app and usually significant to developers 👩‍💻👨‍💻

• New Fields in the CurrentScan table to support the Network tree generation from plugins (🆕)
• Plugin transformers, such as base64 encoding, can be applied to arrays (🆕)
• Settings page refactoring (✨)
• Ability to specify the execution order of plugins with the "execution_order" : "Layer_0" property in config.json (🆕)

Other Info

🆕 - New features	✨ - Fixes & Improvements	⚠ - Possibly breaking changes	🧪 - Experimental/work in progress

What's Changed

• adding wonderfully written omada sdn probe by @FlyingToto in #737

New Contributors

• @FlyingToto made their first contribution in #737

Full Changelog: v24.6.8...v24.7.18

v24.6.8 - 🔄 Sync Hub, 🔌Plugins Unloading, 🔔 UI Notifications

Alright, let's see how many bugs I missed. This is a big release 🎁

This month's NetAlertX release includes three big new features: In-app user notifications, Plugin unloading with the LOADED_PLUGINS setting (making the app much faster), and a new Sync Hub (🧪) plugin. This will enable you to synchronize data from otherwise unscannable LANs/VLANs into one NetAlertX instance. Read the guide here.

Also, you can now get Reconnected devices notifications 📶 of devices that trigger down alerts.

Thank you to everyone in the community helping with this release, especially @vladaurosh 🙏 who helped me keep the docker image small even with the need for some of the cryptography libraries for the new functionality.

I also scored the @NetAlertX Twitter handle, let's see if I'll use it 😅

🔔 Get notified what's new

Get notified about a new release, what new functionality you can use, and about breaking changes.

Make sure you refresh your browser cache (usually shift + reload button) - and click the 🔄 refresh button in the top right corner.

📸Screenshots

🏘️ Community

• @SirAfino, @YoSafeguard, @rasec99cesar, @isuckpotato, @gallegonovato, @mapi68 helped with translations 🙏
• @leiweibau & @vladaurosh helped answer community questions 🙏

📚Docs updates

• Cleaned up Plugins docs and separated it into a Plugins Dev guide (🆕)
• A file permissions guide if you need to run custom backup scripts thanks to @vladaurosh 🙏 (🆕)

⚙Settings

• You can now load new or unload unneeded plugins to speed up the application via the LOADED_PLUGINS setting (🆕) #669
• Further Settings screen optimization to prevent incorrect loads/setting saves (🚑)

🔌Plugins

• A new SYNC plugin allowing you to synchronize multiple instances into one central location (🆕)
• The INTRNT plugin now has a default 3-retry policy adjustable with the INTRNT_RETRIES setting to minimize false internet down reports (🆕) #667
• The newly added MQTT setting MQTT_PRESENCE_SENSOR_TYPE was breaking the notifications (🚑) #664
• MQTT messages now contain the First/Last session per device (🆕) #697

🖼 UI

• A DB-locked icon will be displayed in the Header when the app can't write to the DB (🆕) #685
• In-app Notification log (🆕)

💠Core app updates

Internal changes affecting the whole app and usually significant to developers 👩‍💻👨‍💻

• The app now supports notifications of Reconnected devices that were Down before with the down_reconnected notification option (🆕) #611
• Rebase to Alpine 3.20 by @vladaurosh (🚑)🙏
• @vladaurosh helping me to keep the image small 🙏

Other Info

🆕 - New features	🚑 - Fixes & Improvements	⚠ - Possibly breaking changes	🧪 - Experimental/work in progress

What's Changed

• Update base docker image to alpine 3.20 by @vladaurosh in #688
• upgrading base image to Alpine 3.20, upgrading php to 8.3 by @vladaurosh in #692

Full Changelog: v24.5.9...v24.6.8

v24.5.9 - 🗳️ 🌏 🔍 Setting filters, Community vote, NMAP scanner and more

Hey there!

Friendly reminder: Mothers day is around the corner 💐🌷

On completely unrelated news - a new version of NetAlertX is here! 🧑‍🚀🚀

You know who's amazing? YOU - the community - and that's the only way this app will become sustainable (unless suddenly I can quit my real job 😅). For example @ulrichwisser implemented a new way to clean device names, over in the Weblate online portal you contributed to 🌏 Chinese (@onebest1 🙏), Polish ( @isuckpotato 🙏), Italian ( @mapi68, @SirAfino 🙏), & Portuguese (Brazil) language translations, and helped out in discussions and on various issues (thanks @fcschow for spotting bugs 🐛) . I also thought - Do you want a community portal?

Now to some feature highlights.

You can now use a new NMAP scan plugin 🚀 (@stevenengland, @vladaurosh 🙏 for helping). This one might be great to complement your ARPSCAN scanner if you have devices offline, that should be detected as online.

There are over a 100 settings to fine-tune the app, and that granularity is amazing, but sometimes it's hard to find what you are looking for. You can now filter the settings page 🔍 to find the one setting you are after faster.

Annoyed by changing lists in Settings - because there is a typo and no way to fix it inline? Not anymore - all list settings, such as Subnets, can be edited with single and double-click actions 1x 📝| 2x 🚮.

I tried also addressing various cache/loading issues so I hope this release improves on that as well. Still, you might need to refresh your browser cache - and click the 🔄 refresh button in the top right corner, but I hope this will be less required in the future.

And there is more - just check the details below ⤵️

Screenshots

💔 Breaking changes

Sometimes I have to introduce breaking changes

• pialert-cli was retired and passwords are managed via the Settings UI

🏘️ Community

• Help @aries223 to configure vlans #654
• Do you want a community portal?

📚Docs updates

• A new guide explaining Notifications (🆕)
• Enhancements to the MQTT plugin docs with payload examples (🚑)

⚙Settings

• Three new MQTT settings (MQTT_DEVICE_NAME, MQTT_DEVICE_ID, MQTT_PRESENCE_SENSOR_TYPE) to adjust the messages sent to the broker #572 #639 #664 (🚑, 🆕)
• I moved the SCAN_SUBNETS settings to the General section as most users will need to edit it and the setting is used across multiple plugins (🚑)
• A new NEWDEV_LESS_NAME_CLEANUP setting to leave discovered names more intact by @ulrichwisser 🙏 (🆕)

🔌Plugins

• New NMAPDEV device discovery plugin using NMAP for scanning which should more reliably detect the online/offline state #645 (🆕)
• Resetting the password is working again #634 (🚑)
• The DHCPLSS plugin now also supports the dnsmasq dhcp.leases files format #661 (🆕)
• The VNDRPDT plugin wasn't updating the vendor database since the Alpine re-base (🚑)

🖼 UI

• Edit/Delete 1x 📝| 2x 🚮 support on list items in Settings (🆕)
• Chinese, Polish & Portuguese (Brazil) language translation start > Help translating in Weblate online portal (🆕)
• Select all / Remove all devices in multi-edit (🆕)
• UI Settings refresh improvements (🚑)
• Special characters (e.g. #) in some device fields were causing issues #644 (🚑)
• Settings filter (🆕)
• Mass-edit icons could cause loading issues #660 (🚑)

Other Info

🆕 - New features	🚑 - Fixes & Improvements	⚠ - Possibly breaking changes	🧪 - Experimental/work in progress

Previous releases:

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

Full Changelog: v24.5.9...v24.5.9

24.4.17 - 🚀Introducing NetAlertX, ✨unlimited Icons, and settings for 🔧tweaking the UI

New stuff arrived 🎁

I hope you like the new name and logo. 😅

After thinking for about a year about it I decided to rename the project to 🚀NetAlertX. This will help prevent confusion about which fork someone is using, and differentiate it from the now stale upstream project. With about 1800 or so commits over the stale project, I thought, this project deserved a new name. It will also remove the confusion about only supporting Raspberry Pi's 😵

On top of the rename, I implemented ✨unlimited icons - just find an SVG you like and use it 😄. Migrating existing icons and making the UI play nicely with the change took some effort, but it should be working smoothly now. There are also a couple of UI tweaking settings, so check out the changes below. 🔽

A shout-out to @vladaurosh for quickly helping as I'm sometimes blind and thanks to @wintergew for some UI tweaks. 🙏 There was also @zilvernet who reported a bunch of issues and tested the new icon functionality 👍 Oh and @YoSafeguard added a full Russian translation 🌍💪

Please read the below carefully, but in general, I hope the transition will be smooth and should be mostly fully automated.

Screenshots

💔 Breaking changes

Sometimes I have to introduce breaking changes

The rename from PiAlert to NetAlertX should be pretty straightforward and existing setups should work fine. Still, caution is recommended. On a high-level this is what has changed:

• Existing configuration, database and devices should automatically come over without issues.
• I will keep updating the pi.alert docker hub image for now, but aim to retire it by the end of the year
• device name & manufacturer in the MQTT messages and sensors (HomeAssistant) changed from PiAlert to NetAlertX
• app or netalertx (NetAlertX) prefixes and names are used instead of pialert
• If you mapped/mounted any other folders, make sure you change the base mounting location as per the Migration guide.

🏘️ Community

• What version of Raspberry PI is needed to run the bare-metal install?
• Can you help me develop an Asus router plugin or Mikrotik devices?
• Someone requested an Italian translation so if you speak it - help out if you can (Norwegian & French need also some help)(🧪)

📚Docs updates

• A new migration guide from PiAlert to NetAlertX (🆕)
• Re-written Icons documentation (🆕)

⚙Settings

• You can configure to hide some sections in the Devices page via the UI_DEV_SECTIONS setting #612 (🆕)
• Set the UI_REFRESH setting to auto-refresh the UI #614 (🆕)
• You can now specify a pre-defined list of icons via the UI_ICONS (🆕)

🔌Plugins

• Un-discoverable devices are now always marked as Online #617 (🆕)

🖼 UI

• Support of SVG icons (🆕)
• You can now set the UI to auto-reload if you are running NetAlert in a kiosk-like setup #614 (🆕)
• Further revamp of the navigation (🚑)
• A ticker is displayed if you are using old PiAlert mount locations (🚑)
• The < > arrows were not cycling thru the filtered results #627 (🚑)
• The Tools tab didn't use the correct IP address if you navigated via the < > on the device details #626 (🚑)
• Pro Font Awesome icons mounted into the container work again #594 (🚑)
• Russian translation by @YoSafeguard (🆕)

💠Core app updates

Internal changes affecting the whole app and usually significant to developers 👩‍💻👨‍💻

• The container timezone was different from the app's timezone #599 (🚑)
• The detailed NMAP scan didn't work due to a missing package #623 (🚑)

Other Info

🆕 - New features	🚑 - Fixes & Improvements	⚠ - Possibly breaking changes	🧪 - Experimental/work in progress

Previous releases:

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

What's Changed

• Improve chmod in setup.sh by @vladaurosh in #600
• Removed duplicate manifest tag by @ameer1234567890 in #605
• Design improvements by @wintergew in #619
• Update Dockerfile with nmap-scripts by @vladaurosh in #625

New Contributors

• @ameer1234567890 made their first contribution in #605
• @wintergew made their first contribution in #619

Full Changelog: v24.3.19...v24.4.17

24.3.19 - Multi-edit ✏, Alpine 🏔, Navigation 🧭 and voting on next Icons 🗳

Hey everyone 👋, I have some updates to share!

@vladaurosh made a huge contribution with a rebase to Alpine💪🏔 This should make things run smoother and the image is over 70% smaller. I might need a bit of help ironing out any issues in the bare-metal scripts. If you are using those, please help out if you can.

I've spent time updating the UI with better navigation 🧭 and a simple multi-device edit ✏ function. I've beefed up the docs with backup tips 💾 and the community kicked off translations for Russian, Norwegian, and French 🌎. There are some handy new features for devs to play with, like a nifty docker environment variable for resetting instances or dropdowns populated with SQL queries.

Plus, I want your input! Head over here and let me know if you prefer network independence with self-hosting or if you're all about having options in the next icon pack. Voting closes in a week 🗳

There might be some 💔 Breaking changes depending on your setup, so check them out below.

Keep the feedback coming - I'm all ears!

Screenshots

💔 Breaking changes

Sometimes I have to introduce breaking changes - it breaks my heart, but we must move forward

• Due to the rebase to Alpine the bare-metal scripts may need some debugging and fixes. I did my best and the installation is running, but someone might need to help to make sure PHP/nginx is set up appropriately.
• There are now 2 NGINX files for PiAlert, one for the bare-metal Debian install (pialert.debian.conf), and one for the docker container (pialert.template.conf). Both can be found in the install folder. Map or use the one appropriate for your setup.
• This version has changed the behavior of how the ownership of the /config and /db folders is handled. There's no need to set owner and group for those directories, as the container will change it to 101:82 as that's needed by the nginx webserver running inside. Thus the HOST_USER_ID and HOST_USER_GID variables became obsolete.

🏘️ Community

• Do you prefer being independent in self-hosting or choice in the next icon pack selection? Vote here ✅🗳

📚Docs updates

• How to approach Backups of your configuration (🆕)
• The community started translation of the core UI for Russian, Norwegian, and French. Check the progress, and contribute in Weblate. (🆕)

⚙Settings

• For development and testing, to delete the database and config folders, you can now always reset your instance on container restart using the new ALWAYS_FRESH_INSTALL docker environment variable (🆕)

🔌Plugins

• The PAHO library used for MQTT changed how messages are sent and the publisher was not working #580 (🚑)
• Pushover has now a target device setting, implemented by #588 @Schlump (🚑)

🖼 UI

• Multi-edit of common fields #571 (🆕)
• Cache expiration improvements (🚑)
• Navigation improvements with nested menus (🆕)

💠Core app updates

Internal changes affecting the whole app and usually significant to developers 👩‍💻👨‍💻

• Re-base to Alpine bringing the image size down by around 70% by @vladaurosh 🙏(🆕)
• Added options_params support to dynamically populate dropdowns with database queries (🆕)

Other Info

🆕 - New features	🚑 - Fixes & Improvements	⚠ - Possibly breaking changes	🧪 - Experimental feature

Previous releases:

https://github.com/jokob-sk/Pi.Alert/releases

Full Changelog: jokob-sk/Pi.Alert@v24.3.19...v24.3.19