v1.3.4

WiFi Optimizer gets smarter channel recommendations and more informative visuals.

WiFi Optimizer

• Overlap-aware channel scoring - Cleanest channel recommendations now score candidates against the full channel span at the AP's configured width, not just exact channel matches. Your own APs are included as interference sources too.
• Regulatory channel data - Available channels now come from the UniFi stat/current-channel API, so recommendations match what the UniFi UI actually offers for your country and channel width.
• 6 GHz PSC filtering - Only recommends Preferred Scanning Channels for 6 GHz bands, matching UniFi behavior.
• Band filter on Environmental Correlation - Filter the heatmap and airtime stats by 2.4/5/6 GHz band.
• Heatmap improvements - Smooth gradient coloring, grey cells for missing data, and date range limited to days with actual data.
• Band-segmented generation bars - Wi-Fi generation bars in Airtime Fairness and Band Steering now show band segments (2.4 GHz amber, 5 GHz blue, 6 GHz purple) with per-band client count tooltips.
• Online-only client filtering - All four WiFi Optimizer tabs now filter to online clients only, excluding historical/offline devices from analysis.
• Channel density bars use absolute scale - Bars now reflect actual congestion level instead of being relative to the most congested channel. A single weak neighbor shows a small bar, not a full-width one.

Installation

Windows: Download the MSI installer below

Docker:

docker compose pull && docker compose up -d

macOS (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.sh

Proxmox:

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.

v1.3.3

Security audit accuracy improvements and a big WiFi Optimizer Client Stats refresh.

Security Audit

• IP/CIDR firewall rules now recognized - Rules that block internet via IP/CIDR sources (e.g., 192.168.99.0/24) were previously ignored. The audit now correctly identifies these as internet blocks.
• Zone-aware rule matching - Firewall rules scoped to a custom zone no longer falsely match networks in other zones.
• Port group rules no longer flagged as any-any - Rules using port groups (e.g., "Web Ports") were incorrectly treated as unrestricted.
• Custom zone rules no longer flagged as overly broad - Rules scoped to custom firewall zones (or zones with fewer than 5 networks) are now correctly recognized as narrow-scope rules.
• Internet Block Bypassed now detects port-based allow rules - Port-restricted allow rules (e.g., ports 80, 443) that bypass a network's internet block are now correctly flagged.
• Management internet access no longer masked by Block Invalid Traffic - The predefined "Block Invalid Traffic" rule (which only blocks INVALID connection state) was incorrectly counted as blocking all internet, hiding missing internet restrictions on Management and Security networks.
• Better recommendation text - Several audit findings that were showing generic recommendation text now display specific, actionable guidance.

WiFi Optimizer

• Client Stats table view - See all your clients at a glance in a pageable, sortable table instead of needing to select one from a dropdown.
• Searchable client dropdown - Quickly find clients by name, MAC address, or IP.
• Offline client tracking - Recently disconnected devices appear with last-seen timestamps. Filter by All, Online, or Offline.
• Metrics band filter - Tab-style multi-select for 2.4/5/6 GHz with dynamic chart heights that expand when fewer bands are selected.
• Weak signal alerts include AP name - Easier to identify where signal issues are occurring.
• Restyled progress bars - Consistent styling across all WiFi Optimizer tabs.
• Mobile-friendly improvements - Tabs scroll horizontally on smaller screens, issue icons display correctly.

Installation

Windows: Download the MSI installer below

Docker:

docker compose pull && docker compose up -d

macOS (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.sh

Proxmox:

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.

v1.3.2

Major Wi-Fi Optimizer refactor with a centralized rule engine, plus expanded device type support.

Wi-Fi Optimizer

• Centralized rule engine - Recommendations are now generated by 21 individual rules instead of inline component logic. This makes the system more maintainable and testable, and ensures consistent behavior across all Wi-Fi Optimizer tabs.
• PPSK network detection - IoT network detection now checks Private Pre-Shared Key bindings in addition to direct network assignments, so the IoT SSID recommendation correctly suppresses when you have PPSK-based IoT segmentation.
• Non-standard channel detection - New rule flags 2.4 GHz APs using channels other than 1, 6, or 11, which cause overlap interference.
• Overview filtering - Informational recommendations (like "Consider Minimum Data Rates") now only appear on their relevant tabs, keeping the overview focused on actionable issues.
• Neighboring Networks pagination - Large neighbor lists in RF Environment are now paginated (25 per page) for better performance.
• Visual improvements - Nested cards alternate colors by depth for better hierarchy, band-tab styling on RF Environment, and consistent 24x24 issue icons.

Dashboard

• Additional device type mappings - Support for UNAS (NAS devices), Talk phones, SFP Wizard, Cable Internet modems, and Travel Routers. Also added alternate type codes for Device Bridge, Application Server, UNVR, and other existing devices.

Installation

Windows: Download the MSI installer below

Docker:

docker compose pull && docker compose up -d

macOS (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.sh

Proxmox:

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.

v1.3.1

Improvements to WiFi Optimizer with better health detection and device filtering.

WiFi Optimizer

• 6 GHz disabled detection - Detects when APs have 6 GHz radios but no SSIDs broadcast on 6 GHz, suggesting users enable it to offload capable devices from congested bands.
• MLO status tracking - Multi-Link Operation is now tracked as an Info-level health issue when enabled on Wi-Fi 7 capable APs, with guidance about potential throughput impact on non-Wi-Fi 7 devices.
• SmartPower device exclusion - USP-Strip and USP-Plug are now correctly filtered out. These devices return type=uap in the UniFi API but aren't actual access points.
• Mesh pair filtering - Mesh parent/child pairs are now excluded from "High Power Overlap" warnings since they intentionally share channels for uplink communication.
• Multi-dimension health issues - Health issues can now appear on multiple relevant tabs (e.g., "6 GHz disabled" shows on both Band Steering and Airtime Fairness).
• Consistent AP ordering - All AP lists are now sorted by IP address (ascending) for predictability across tabs.
• Hidden network identification - RF Environment now identifies known hidden networks by BSSID pattern, starting with Xbox Wi-Fi Direct.

Dashboard

• All device types supported - Dashboard now correctly displays all UniFi Network device types including BuildingBridge, CloudKey, DeviceBridge, and SmartPower with appropriate icons. Note: this is limited to what UniFi Network returns on the API call, so some devices still may not show.

Speed Test

• Fixed trace link lines - CSS issue from Wi-Fi Optimizer broke the arrows on the speed test trace lines, but it is fixed now.
• AP MLO status - I've noted some difference in throughput for non-MLO clients with MLO enabled, so I added a feature to trace whether MLO is enabled on capable WiFi 7 (be) APs.

Installation

Windows: Download the MSI installer below

Docker:

docker compose pull && docker compose up -d

macOS (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.sh

Proxmox:

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.

v1.3.0

New major feature: Wi-Fi Optimizer - Site health scoring, signal analysis, and optimization recommendations for UniFi wireless networks.

Wi-Fi Optimizer

Twelve analysis tabs providing comprehensive wireless network insights:

• Overview - Site health score (0-100) across six dimensions, band distribution, health issues, and per-AP summaries
• Metrics - Time-series performance graphs with airtime, interference, and TX retry overlays
• RF Environment - Neighboring network detection, channel density comparison, and cleanest channel identification
• Channels - Channel map visualization with AP assignments, utilization, and co-channel interference detection
• Client Stats - Per-client connection details, signal history, and roaming event timeline
• Roaming - AP topology diagram with path quality, success rates, and fast roaming (802.11r) metrics
• Power/Coverage - Signal distribution histogram, TX power levels, coverage quality, and overlap detection
• Load Balance - Client distribution per AP with band breakdown and imbalance detection
• Connectivity - Connection stage flow visualization with success rates and issue identification
• Band Steering - Steering effectiveness, client capabilities by Wi-Fi generation, and legacy device inventory
• Airtime - Radio utilization, airtime impact by Wi-Fi generation, and potential airtime hog identification
• Environment - Performance by time of day and weekly interference pattern heatmaps

All recommendations include specific UniFi Network UI navigation paths for applying changes.

SSH Credential Testing

• Multi-device validation - SSH credentials are now tested against multiple device types (switches and APs) to ensure they work across your network before running speed tests

Installation

Windows: Download the MSI installer below

Docker:

docker compose pull && docker compose up -d

macOS (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.sh

Proxmox:

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.

v1.2.1

A quick fix release to improve security device categorization in the audit.

Security Audit

• Security systems show correct audit titles - Alarm panels and access control devices now display "Security System on Wrong VLAN" instead of incorrectly showing "Camera on Wrong VLAN"
• Smart sensors reclassified as low-risk - Temperature sensors, air quality monitors, and similar devices no longer trigger Critical severity warnings
• Improved device fingerprinting - Smart smoke detectors (Nest Protect, Kidde, First Alert, etc.) were incorrectly categorized as cameras; they now correctly categorize as sensors. Alarm systems properly group with security devices.

Installation

Windows: Download the MSI installer below

Docker:

docker compose pull && docker compose up -d

macOS (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.sh

Proxmox:

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.

v1.2.0

This release adds new Config Optimizer and Security Audit checks and suggestions, and wraps up all the features and improvements from the v1.1.x series.

What's New in 1.2

If you're upgrading from v1.1.0 or earlier, here's everything that's been added:

• 802.1X and VLAN audits - New rules catch trunk profiles missing 802.1X, access ports with excessive tagged VLANs, and trunk ports allowing too many VLANs
• Smarter UPnP audit - Checks which specific networks have UPnP enabled, not just whether it's on globally
• Broader VLAN isolation coverage - Audit now checks ALL network types against Security and Management VLANs
• Smarter firewall rule evaluation - Correctly handles UniFi's RESPOND_ONLY rules that were causing false negatives
• Wireless rate snapshots - Speed tests capture WiFi link rates at multiple points during a test
• Speed test traces - Certain problematic network paths and directions now show negotiated link speeds instead of assuming max capability
• Speedtest conflict detection - Adaptive SQM knows when a speedtest is already running and won't start another
• Adaptive SQM log viewer - Pull up the last 50 lines of each WAN's log right from the UI
• Adaptive SQM works in the EU - Added GDPR consent flag for Ookla's speedtest CLI
• Proxmox LXC installer - One-liner to spin up Network Optimizer in a lightweight container
• Site ID validation - Clear errors when your configured site ID is wrong, instead of silent "0 devices"

Since 1.1.9

Config Optimizer

• Port profile suggestions - Suggests applying existing profiles when just 2 ports match, or creating new profiles when 5+ ports share identical configurations. Covers disabled ports and unrestricted access ports.

Security Audit

• Trunk port VLAN check - Flags trunk ports allowing excessive VLANs even when no device is connected, helping catch misconfigured uplinks.

• Smarter audit bypasses - Recognizes intentional unrestricted port profiles and skips warnings for those ports.

• Actionable recommendations - Audit issues now show specific remediation steps instead of generic "Review the configuration" messages.

Fixes

• European locale support - Adaptive SQM scripts now work correctly on systems with comma decimal separators (German, French, etc.).

• Pi-hole DNS validation - WAN DNS validation now works correctly for Pi-hole/AdGuard users who don't have DoH enabled on the gateway.

• Ping check reliability - Simplified the ping validation logic and improved error messages for Adaptive SQM deployment troubleshooting.

Installation

Windows: Download the MSI installer below

Docker:

docker compose pull && docker compose up -d

macOS (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.sh

Proxmox:

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.

v1.1.9

This release fixes speed detection for SFP+ modules running at negotiated speeds and improves network path visualization.

What's New

• 802.1X configuration audit - New audit rule detects trunk port profiles that are missing 802.1X authentication settings, helping ensure network access control is properly configured.

• Access port VLAN audit - New audit rule identifies access ports with excessive tagged VLANs, which can indicate misconfiguration or potential security issues.

Speed Test Fixes

• SFP+ speed detection - Network paths now correctly show the negotiated link speed for SFP+ modules (e.g., 1 GbE instead of assuming 10 GbE). Previously, return paths through the gateway would show incorrect speeds for ports running below their maximum capability.

• Bottleneck highlighting - When multiple wired links share the same bottleneck speed, all are now highlighted in the path visualization instead of just the first one.

• Wireless mesh link speed - Mesh links now display the TX rate (To Device direction) matching the tooltip, instead of the RX rate.

Other Fixes

• WAN DNS validation - Pi-hole and AdGuard Home DNS servers are now correctly validated for WAN interfaces, fixing false warnings about missing DNS configuration.

• Adaptive SQM deployment reliability - Added ping target validation before applying SQM settings to prevent deployment failures on unreachable hosts. Made SQM ping adjustment script more durable.

Installation

Windows: Download the MSI installer below

Docker:

docker compose pull && docker compose up -d

macOS (native, recommended for accurate speed tests):

git clone https://github.com/Ozark-Connect/NetworkOptimizer.git && cd NetworkOptimizer && ./scripts/install-macos-native.sh

Proxmox:

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.

v1.1.8

This release improves device detection accuracy and makes VLAN recommendations more helpful.

What's New

• GoPro cameras no longer flagged as security cameras - GoPro action cameras share the same UniFi fingerprint category as security cameras, which caused false "Camera on Wrong VLAN" warnings. They're now correctly identified as consumer devices.

• Clearer VLAN recommendations - When a device is on the wrong VLAN, the recommendation now includes a hint about how to fix misclassified devices by changing the Device Icon in UniFi Network.

• Improved device detection messages - Detection source labels are now more descriptive (e.g., "Fingerprint Override" instead of just "Override").

Installation

Windows: Download the MSI installer below

Docker:

docker compose pull && docker compose up -d

macOS (native, recommended for accurate speed tests):

git clone https://github.com/Ozark-Connect/NetworkOptimizer.git && cd NetworkOptimizer && ./scripts/install-macos-native.sh

Proxmox:

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.

v1.1.7

A few fixes and improvements, plus a new Proxmox installation option.

What's New

• Proxmox LXC installation script - One-liner to spin up Network Optimizer in a lightweight Proxmox container. Uses Debian 13 by default.

Fixes

• Fingerprint database cache no longer gets poisoned - If your Console can't reach *.ui.com (firewall rules, DNS issues, etc.), the empty response was cached for 24 hours, blocking retries. Now it retries on each audit until successful, and shows a critical audit issue if fingerprints are unavailable.

• Nest Protect smoke alarms no longer detected as cameras - The word "Protect" in the name was triggering camera detection. Fixed.

• 23 additional device type mappings - Better classification for various IoT devices, appliances, and network equipment that were falling through to Unknown.

Installation

Windows: Download the MSI installer below

Docker:

docker compose pull && docker compose up -d

Proxmox:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ozark-Connect/NetworkOptimizer/main/scripts/proxmox/install.sh)"