Prerequisites
What you need before installing Insights Plus.
Required
- Docker and Docker Compose
- UniFi Router - or any UniFi gateway that supports remote syslog
Optional (Recommended)
- MaxMind GeoLite2 account (free signup) - required for automatic GeoIP database updates. Without it, the container uses bundled GeoLite2 databases that work out of the box but will not auto-update
- AbuseIPDB API key (free tier) - for threat scoring. 1,000 lookups/day + 5 blacklist pulls/day
- UniFi API key or controller credentials - for auto-detecting WAN, VLANs, and device names. UniFi OS controllers use an API key (Local Admin); self-hosted controllers use a local username and password. Firewall syslog management is only available on UniFi OS
Minimum Host Resources
| Resource | Minimum |
|---|---|
| CPU | 2 cores/threads (PostgreSQL + receiver + API run concurrently) |
| Disk | 10 GB free for the database volume at minimum |
These are baseline estimates for a small home network. Higher log volume or longer retention will require more disk.