On-Site Agent update (optional; the v2.9.0 Agent, unchanged in v2.9.1): if you skipped v2.9.0, its Agent reads a UniFi Cable Internet's signal levels. It only matters on a site with a UCI, for the Agent on your UniFi Gateway. Open Settings - Multi-Site, expand your site, and press Run It for Me under the upgrade command, or run the upgrade command yourself. If you updated on v2.9.0 or v2.9.0-preview9, you're set.
The AP Agent now runs on older MIPS access points (U6-Lite, U6-Mesh, UAP-AC-Pro, and others), and every page has a Back button. Also some fixes in AP Telemetry, Client Performance, Monitoring, and alerts, and the Audit Log now records what Network Optimizer does on its own. See the v2.9.0 release notes for what's new in v2.9.0+.
AP Telemetry
- MIPS access points - the AP Agent now runs on older MIPS-based access points such as the U6-Lite, U6-Mesh, and UAP-AC-Pro, alongside the ARM-based U6 and U7 (#1203, thanks @dpackham for the request, @Confenet for the implementation in #1239 this builds on and production measurements across five UAP-AC-Pros, and @tusc for testing on a U6-Mesh).
- Running natively on Linux from source? The Native Deployment Guide has the two new builds; Docker, the MSI, and the macOS installer already include them.
- Fix: an access point with the wrong time showed Token mismatch - an AP whose clock is more than a few minutes off (usually NTP blocked on its management network) has its AP Agent reject every request Network Optimizer sends, and the AP Telemetry status showed Token mismatch instead of the real cause. It now shows Clock out of sync with how far off the clock is, and a deploy confirms the agent actually answers before it reports success.
Back Button
- Back - every page now has a Back button beside its title, so an installed app with no browser chrome has a way back (#1243, thanks @KittyFarts for the request). It shows only when there is a Network Optimizer page to go back to.
Client Performance
- Fix: no Wi-Fi data for a client that just joined (AP Agent) - a phone rejoining the LAN could show no Wi-Fi data for up to about 40 seconds, until UniFi Network caught up. It now shows from the join, under the client's UniFi Network name rather than its DHCP hostname.
- Fix: stuck on your VPN client after coming back on the LAN - opened over a VPN (Tailscale, UniFi Teleport, or a plain VPN), the page kept showing your VPN client after the browser reconnected on the LAN. It now switches to your Wi-Fi client device.
Monitoring
- Fix: an Express adopted as an AP was monitored at the gateway's address - an Express (or Dream Router) adopted as an AP behind another gateway had its automatic target in Latency Targets and its SNMP polling pointed at the gateway's LAN IP. Both now use its own address (#1244, thanks @tempeduck).
Alerts & Schedule
- Fix: the radio reset warning could fire on healthy radios (AP Agent) - Wi-Fi: Radio Resetting could fire on a 2.4 or 5 GHz radio that was serving clients fine. It now warns only on 6 GHz, the one band where a rising reset count has presented before a radio stopped transmitting, and Wi-Fi: Radio Stopped Transmitting still covers every band (#1242, thanks @Jason-Morcos).
Audit Log
- Actions Network Optimizer takes on its own - Firmware Rollout's Autopilot scheduling a plan, a plan starting on schedule, a start postponed by the health check, and an abort with nothing left to update; the AP Agent redeploying, upgrading, or restarting an agent; and a WAN speed test or Adaptive SQM learning schedule turned off automatically. Each shows Network Optimizer as the actor, with the reason. Canceling Run It for Me is logged too.
- Fix: the Audit Log filled with access-denied entries nobody caused - an internal cleanup in the cellular modem monitor was refused and logged each time it ran, thousands of rows per site, burying real denials. It no longer happens, and the upgrade clears the existing rows.
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.