On-Site Agent update (the v2.8.0 Agent, unchanged in v2.8.1, v2.8.2, v2.8.3, and v2.8.4): if you skipped v2.8.0, the measured per-client WAN accounting needs the v2.8.0 Agent on your UniFi Gateway, and the switch-port naming fix needs it on any Agent that does your SNMP collection. Open Settings - Multi-Site, expand your site, and run the upgrade command there; on a UniFi Gateway, Run It for Me runs it for you over SSH. Your enrollment is kept, and the app prompts you when an Agent is behind. If you updated on v2.8.0, v2.8.0-preview8, v2.8.1, v2.8.2, or v2.8.3, you're set.
A Fan Control Tuning fix for UniFi OS 6.0.x EA, fixes for quiet devices not showing Wi-Fi history, a fix for a false Unused Width recommendation in the Wi-Fi Optimizer, an opt-in filter for a known DDM read glitch on SFP ONTs, and some small fixes to Firmware Rollout alerts, Dashboard reboot reasons, and the LAN map. See the v2.8.0, v2.8.1, v2.8.2, and v2.8.3 release notes for what's new in v2.8.0+.
Performance Tweaks
- Fix: Fan Control Tuning had no effect on UniFi OS 6.0.x EA - UniFi OS 6.0 changed which service controls the fan, so the gateway kept UniFi's factory setpoints. Redeploy it on UniFi OS 6.0.x EA or later.
Client Performance
- Fix: a device you are watching was slow to come back after it reconnected - the page held Device Offline and its last readings for about ten seconds while it waited on the Console to relist the device. It now follows the access point, which sees the association first. (for AP Telemetry sites)
- Fix: a device that stays connected but sends nothing dropped out of Wi-Fi history - a TV, a printer or a sleeping game console is associated and answering its access point while sending no data, and the access point stopped recording it: Signal and Connection thinned out to the Console's own readings, and the device went missing from the map's timeline playback entirely. On a site where every device is that quiet, there was no Wi-Fi client history at all. (for AP Telemetry sites)
Wi-Fi Optimizer
- Fix: a false Unused Width recommendation - a client that had negotiated 160 MHz could be read as 80 MHz, and the AP would be told to narrow. Channel Recommendation shared the same bad reading. Both now look back two weeks of per-client history, kept in a daily rollup (InfluxDB is a little busier for about fifteen minutes after updating, once).
Monitoring
SFP Stats
- Ignore single-poll DDM spikes on SFP ONTs - a known DDM read pattern on some SFP ONT sticks: temperature and RX power jump together for one poll, then return to normal, raising High Temperature and RX Power Low alerts and drawing spikes on the charts. Off by default; turn it on under SFP Alert Thresholds. Anything that holds for two polls still alerts.
Live View
- Fix: double-click did nothing on a client that had just roamed - the client held its place on the map but lost its IP, SSID and network until you refreshed the page, so a double-click had nothing to open Client Performance with. Timeline playback showed the same blank client.
Firmware Rollout
- Fix: Device Offline alerts right after a Network application update - devices re-adopt for a minute or two after the rollout reports complete, and that minute fell outside the quiet window even with Skip the usual offline and restart alerts ticked.
Dashboard
- Fix: a Console upgrade recorded as a power loss - on a slow boot, a UniFi OS Console's reason could be copied from a previous boot (seen on a UCG-Fiber upgrading to UniFi OS 6.0.7). Reasons already on file are re-read and corrected after updating.
Fixes
- A repeated query warning in the application log - "The query uses the 'First'/'FirstOrDefault' operator without 'OrderBy'", hundreds of lines a day on a busy install (#1210, thanks @bondskin).
- Also: on Multi-Site installs, each site's hourly usage rollups now run at their own minute so they don't compete for InfluxDB resources.
Installation
Windows: Download the MSI installer below
Docker (Upgrade):
docker compose pull && docker compose up -dmacOS (native, recommended for accurate speed tests vs Docker Desktop):
git clone https://github.com/Ozark-Connect/NetworkOptimizer.git && cd NetworkOptimizer && ./scripts/install-macos-native.sh
# or if you already have it cloned
cd NetworkOptimizer && git pull && ./scripts/install-macos-native.shProxmox:
bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ozark-Connect/NetworkOptimizer/main/scripts/proxmox/install.sh)"
# or if you just need to update
pct exec <CT_ID> -- bash -c 'cd /opt/network-optimizer && docker compose pull && docker compose up -d && docker image prune -f'For other platforms (Synology, QNAP, Unraid, native Linux) or new installations, see the Deployment Guide.