On-Site Agent update (the v2.8.0 Agent, unchanged in v2.8.1 and v2.8.2): 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, or v2.8.1, you're set.
Adaptive SQM can now learn your line's own weekly congestion curve instead of assuming one for the connection type, and on cellular, satellite, and fixed wireless the upload rate follows the schedule too. UniFi OS 6.0.7 EA, the first 6.0.x release for the UCG line, also gets Performance Tweaks support, and Client Performance's Data Usage gets its days right. See the v2.8.0 and v2.8.1 release notes for what's new in v2.8.0+.
Adaptive SQM
- Congestion Profile Learning - a week of brief hourly gateway speed tests, taken only while the WAN is idle and clear of your scheduled WAN speed tests, builds the congestion curve from what your line actually does hour by hour and day by day. A wild reading is thrown out and an odd one is softened by the hours around it, and Severity tunes a learned curve exactly as it tunes the built-in one.
- Each sample moves real data: about 150 MB on a 250 Mbps line, so up to 25 GB across the week. The card shows the estimate for your speeds before you start, which matters on a capped cellular plan.
- Deploy Settings once after updating, before you start learning. Adaptive SQM's own adjustments stay out of the way during a sample only with the updated scripts on the gateway; the card tells you while that is still needed.
- Upload Strength - on Fixed LTE/5G, Starlink, and Fixed Wireless (WISP), upload can be shaped by the congestion schedule too. The slider sets how far it may drop at busy hours, and it never goes below half your nominal upload speed. Existing setups keep a fixed upload rate until you move the slider.
Performance Tweaks
- UniFi OS 6.0.7 EA on the UCG line - verified and supported (bench-verified and lab-tested on UCG-Fiber, thanks @Optic00 for the live verification on his). The UXG line's ceiling stays at 6.0.5.
Monitoring
Live View
- Fix: Bandwidth Hogs during playback - scrubbing back showed one set of figures, then replaced them a couple of seconds later. It shows one answer now, and on a site with a Gateway Agent it arrives seconds sooner.
- Fix: Bandwidth Hogs took seconds to refresh on sites with a Gateway Agent - the longer windows especially. It is quick now.
ISP Health
- Fix: asked for Upstream Discovery you had already run - if UniFi Network has a pre-configured, never-cabled Internet 2 sitting first in the failover order, it reports that as your primary WAN, and ISP Health believed it over the connection your traffic actually uses. It now scores the WAN Upstream Discovery traced (#1207, thanks @khiles for the database dump).
Client Performance - Data Usage
- Fix: 7d and 30d bars began the evening before - last night's downloads showed on today's bar. Days now start at midnight in your install's time zone.
- Fix: 7d and 30d were slow to open - the totals and chart show as soon as they are ready, and the Applications table loads on its own.
Fixes & Improvements
- Dashboard Live View WAN filter after a Console outage - it came back without your default WAN until you left the page and returned.
- Sortable columns, one look everywhere - every sortable table (Bandwidth Hogs, the Applications and Signal tables on Client Performance, Port Statistics, the statistics under every Monitoring chart, and the Wi-Fi Optimizer tables) now shows the same chevrons: a muted pair on any column you can sort, a single blue one on the column you did. Bandwidth Hogs' Download and Upload columns sort now too.
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.
