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_KEY is 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.