UniFi Log Insight v1.1.0

First-run setup wizard, dynamic configuration, multi-WAN support, and pre-built Docker images — no more editing Python or JS files to configure your network.

Docker Image

docker pull ghcr.io/jmasarweh/unifi-log-insight:latest

Available for linux/amd64 and linux/arm64. See the README for a complete docker-compose.yml or the Unraid Setup section for step-by-step Unraid Docker UI instructions.

What's New

Pre-built Docker Image

• Published to GHCR — ghcr.io/jmasarweh/unifi-log-insight:latest (also tagged per version: v1.1.0, v1.1, v1)
• Multi-architecture — builds for both linux/amd64 and linux/arm64
• No cloning or building needed — just pull, add a .env, and docker compose up -d
• Unraid-friendly — install directly from Unraid's Docker UI with port, volume, and env var mappings

Setup Wizard

• Three-step first-launch wizard — auto-detects WAN interface(s) and network segments from live syslog traffic
• WAN detection with polling — waits for logs to arrive, resolves WAN IP automatically
• Network labelling — name each interface (e.g., "IoT" instead of "br20") through the UI
• Configuration stored in PostgreSQL — persists across container rebuilds, no config files needed

Multi-WAN Support

• Select multiple WAN interfaces for failover or load-balanced setups
• Per-WAN labelling with automatic defaults ("WAN", "WAN 1", "WAN 2")

Reconfiguration

• Settings gear in the top-right corner opens the wizard in reconfigure mode
• Pre-populated with current config — change WAN interfaces or labels anytime
• Hot-reload — receiver picks up config changes via signal, no restart needed
• Direction backfill — when WAN interfaces change, existing logs are retroactively reclassified

Dynamic Interface Labels

• User-defined labels replace hardcoded interface names throughout the UI
• Color-coded direction badges (e.g., "IoT → WAN") in the log stream
• Labels apply retroactively to all existing logs
• Migration notification for existing users upgrading from v1.0.0

Interface Filter

• Multi-select filter in the filter bar — search by interface name or label
• Works across log stream and CSV export

Other Improvements

• Add VLAN interface — manually register VLANs that haven't appeared in logs yet
• Label validation — max 20 characters, alphanumeric + spaces/hyphens/underscores, duplicate detection
• Rescan button always visible during WAN detection (not just in reconfigure mode)
• AbuseIPDB budget — removed safety buffer; manual and automatic enrichment share the full daily quota
• CSV export now supports service and interface filter parameters
• .gitattributes enforces LF line endings for Docker/Linux compatibility

Breaking Changes

None. Existing v1.0.0 installations upgrade seamlessly:

• The system_config table is created automatically on first boot
• Default WAN interface (ppp0) and empty labels are applied via auto-migration
• A one-time notification banner prompts users to configure via the Settings gear

Known Limitations

• DNS logging still requires additional UniFi configuration that may not persist across firmware updates. See DNS Logging for alternatives.
• WAN IP detection requires a few minutes of firewall logs to accumulate before the wizard can identify the WAN IP. If it doesn't appear immediately, click "Rescan Logs" after traffic flows.
• Router-originated traffic (e.g., NTP, DNS from the gateway itself) may show as "unknown" direction since it doesn't traverse a WAN interface.

Upgrade from v1.0.0

# If using pre-built image:
docker compose pull && docker compose up -d

# If building from source:
cd unifi-log-insight && git pull
docker compose up -d --build

No data loss — PostgreSQL volume is preserved. On first load after upgrade, a notification banner will prompt you to configure your network via the Settings gear. The old manual parsers.py / utils.js edits are no longer needed and will be ignored.

New Install

docker pull ghcr.io/jmasarweh/unifi-log-insight:latest
# Create docker-compose.yml and .env (see README)
docker compose up -d
# Configure UniFi syslog → <docker-host-ip>:514
# Open http://<docker-host-ip>:8090 — the Setup Wizard will guide you