Patch for v1.7.0 - fixes a crash that blocked SSH device setup on networks without QoS configured. See v1.7.0 release notes for what's new in v1.7.0+.
Patch Fix
- Fixed crash during SSH device setup - UniFi API returns empty strings for WAN QoS fields on networks without QoS configured, which caused JSON parsing to fail. This blocked the entire SSH device configuration flow, preventing features like LAN speed tests and trace enrichment from working.
v1.7.0 Release Notes
v1.7.0 adds Performance and Cellular Data Savings checks to the Config Optimizer, plus speed test trace enrichment that shows device-level settings along the network path.
What's New Since v1.4.0
For users upgrading from older versions, here's what you've missed:
- Client Performance dashboard (v1.6.0) - Per-client signal quality, walk-test GPS mapping, connection history, and roaming events
- Planned AP placement (v1.6.0) - Place any AP model from a 30+ model catalog on your floor plan to simulate coverage before buying hardware
- Signal Map floor plan editor (v1.5.0) - Draw building layouts with wall materials, place APs, and see real-time RF propagation heatmaps with per-band TX power simulation
- Gateway-direct WAN speed testing (v1.4.1) - Speed tests directly from your UniFi gateway against Cloudflare's edge network
- WAN upload accuracy fix (v1.6.4) - Increased concurrent streams and fixed connection reuse for more accurate upload measurements
- Better Apple device detection (v1.6.6) - HomePods and Apple TVs correctly identified via MAC OUI when UniFi fingerprints are generic
See v1.6.0, v1.5.0, and v1.4.0 release notes for the full breakdown.
Config Optimizer
- Performance checks - New analyzer evaluates hardware acceleration, jumbo frames, and flow control settings across your switches and gateway. Detects devices using per-device overrides instead of inheriting global switch settings, and suggests absorbing the global config when they match.
- Cellular Data Savings - For networks with a cellular modem (LTE/5G), checks QoS rule coverage across streaming, downloads, gaming, and VoIP categories. Severity adjusts based on whether the cellular WAN is failover-only or load-balanced, and whether your data plan has a cap.
- UX improvements - Section headers highlight based on severity, unchecked sections preserve existing results until the next run, and various layout polish.
LAN Speed Test
- Trace enrichment - Speed test network path traces now show jumbo frames, flow control, and hardware acceleration status per hop. Switches show jumbo + flow control, gateways show jumbo + hardware acceleration. APs are excluded (confirmed via SSH they don't participate in global switch settings).
Client Performance
- Bug fixes - Fixed empty state messaging, latency display, speed unit colors, and default time range when linking from other pages.
Fixes
- Password reset script - Fixed password capture on macOS/Linux, BSD sed compatibility, and dynamic install directory detection.
Installation
Windows: Download the MSI installer below
Docker:
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)"For other platforms (Synology, QNAP, Unraid, native Linux), see the Deployment Guide.