UniFi Statistics

A modern real-time UniFi network awareness dashboard developed by ScottiBYTE.

UniFi Statistics provides enhanced visibility into network activity, client behavior, recently disconnected systems, unnamed devices, and historical bandwidth usage in a clean and lightweight web interface.

---

Dashboard Overview

---

Features

• Consolidated gateway, WAN, client, and infrastructure health
• Live WAN throughput, CPU, memory, uptime, and Internet status
• Recently detected, offline, returned, and unnamed client tracking
• Combined recent network activity view
• UniFi device firmware and poor Wi-Fi client warnings
• Access-point client, channel, and utilization statistics
• Top network talkers and client classification
• Traffic-counter fallback for controllers without live client rates
• Named network ranges with normalized CIDR notation
• Configurable dashboard refresh interval, including Off
• Collapsible historical charts and network configuration details
• Platform-aware UniFi OS and gateway release-note links
• Support for integrated consoles and self-hosted UniFi OS with UXG gateways
• Persistent local history and baseline data
• Read-only UniFi API interaction
• Docker deployment support

---

Quick Start

Create .env

UNIFI_URL=https://192.168.1.1
UNIFI_USERNAME=your_username
UNIFI_PASSWORD='your_password_here'
UNIFI_SITE=default
PORT=3050

Passwords containing $ symbols must be wrapped in quotes.

---

docker-compose.yml

services:
  unifi-statistics:
    image: scottibyte/unifi-statistics:v2.4.0
    container_name: unifi-statistics
    restart: unless-stopped

    ports:
      - "80:3050"

    env_file:
      - .env

    volumes:
      - ./data:/app/data

---

Deploy

docker compose up -d

---

Access the Dashboard

http://SERVER-IP/

Example:

http://192.168.1.50/

---

Data Storage

Persistent application data is stored locally in:

./data

No additional config.json file is required.

---

Docker Tags

Tag	Description
latest	Current production build
v2.4.0	Network visibility, configurable refresh, and dashboard layout improvements
v2.3.0	Platform-aware release links and refreshed dashboard interface
v2.2.0	Update availability and release-channel awareness
v1.0	Initial stable release

---

Docker Hub

https://hub.docker.com/r/scottibyte/unifi-statistics

---

🌐 Community

Community Support

Need help with Unifi Statistics, Docker deployment, Incus profile management, container creation, or ScottiBYTE utilities?

Join the ScottiBYTE Rocket.Chat community:

Join ScottiBYTE Rocket.Chat

New users can start in #general. From there, you can find other ScottiBYTE project channels and community discussions.

For bugs and feature requests, please continue to use GitHub Issues. For quick questions and community discussion, use Rocket.Chat.