Introduction
The UniFi Dashboard is a high-performance, real-time monitoring solution designed to provide a unified view of UniFi network infrastructure across multiple sites. By acting as a specialized observation layer, it allows network administrators to monitor health metrics, track client connectivity, and manage large-scale deployments without the overhead of switching between individual site controllers.
Built with a focus on simplicity and security, the application utilizes a "Backend-for-Frontend" (BFF) architecture to securely proxy requests to the UniFi API, ensuring that sensitive credentials remain server-side while providing a fluid, reactive experience in the browser.
Key Capabilities
📊 Real-Time Network Visibility
The dashboard maintains a constant pulse on your infrastructure, providing:
- Automated Polling: Data refreshes every 15 seconds with a visual countdown timer to ensure you are always looking at current information.
- Site Health Inference: Intelligent detection of site availability based on the collective status of connected devices.
- Aggregated Statistics: A high-level overview of total sites, devices, and clients across your entire portfolio.
🔔 Intelligent Event Notifications
Stay informed of network changes through an integrated notification system:
- Connection Tracking: Visual alerts trigger immediately when clients connect or disconnect from the network.
- Audio Alerts: Optional sound notifications (with a global mute toggle) provide an audible cue for network activity.
- History Persistence: A transient notification log tracks events during your active session for quick review.
🎛️ Advanced Site Management
Manage complex environments with granular filtering tools:
- Site Persistence: Your site selection and collapse/expand preferences are saved locally, maintaining your workspace configuration across refreshes.
- Quick Filters: Instantly toggle between all sites, online-only sites, or custom selections to reduce noise in large environments.
- Responsive Control: A mobile-friendly interface with dedicated dark and light modes, optimized for both desktop NOCs and on-the-go monitoring.
Secure Architecture
To overcome modern browser security constraints and protect your infrastructure, the UniFi Dashboard employs a Backend-for-Frontend (BFF) pattern.
- Security: Your
UNIFI_API_KEYis never exposed to the client-side browser. - CORS Management: The Express-based server handles all Cross-Origin Resource Sharing (CORS) requirements, allowing the frontend to communicate seamlessly with the UniFi API proxy.
- Docker Optimized: The application is distributed as a lightweight Alpine-based Docker image, designed to run under non-root privileges with built-in health checks.
Use Cases
The UniFi Dashboard is engineered for environments where multi-site oversight is critical:
- Managed Service Providers (MSPs): Monitor client infrastructure from a single pane of glass.
- Rental Property Management: Track network health across multiple short-term or long-term rental units.
- Distributed Business Locations: Oversee branch office connectivity and client loads in real-time.