X-ONU-SFPP Dashboard

This is the official unRAID support thread for X-ONU-SFPP Dashboard.

X-ONU-SFPP Dashboard is a lightweight monitoring dashboard for the EXEN X-ONU-SFPP and compatible ONTs running 8311 community firmware.

It provides live and historical XGS-PON telemetry, configurable server-side alerting, alert history, notification support, and optional advanced monitoring over SSH.

Features

Core monitoring does not require SSH and includes:

• RX and TX optical power

• TX bias current

• Module voltage

• Optical temperature

• CPU temperatures

• PLOAM state

• ONT reachability

• Historical optical and temperature charts

• Configurable telemetry and alert-history retention

Optional SSH-based advanced monitoring adds:

• Live download and upload rates

• Downloaded and uploaded byte counters

• FEC status and counters

• BIP errors

• HEC counters

• PLOAM MIC errors

• Active ONT alarms

• GEM key-error counters

• ONT uptime

• Memory and load information

• Ethernet GEM / Allocation information

• Optical module information

• Historical traffic charts

SSH monitoring is completely optional. If SSH is disabled or unavailable, normal core monitoring continues to operate.

Alerts & Notifications

The dashboard includes server-side alert monitoring, so the dashboard does not need to remain open in a browser for alerts and notifications to function.

Alerts can monitor conditions including:

• RX and TX optical power

• Optical and CPU temperatures

• PLOAM state

• ONT reachability

• Active ONT alarms

• GEM key errors

• BIP, FEC, and HEC counters

• PLOAM MIC errors

Supported notification providers include:

• Discord

• ntfy

• Gotify

• Pushover

• Generic Webhook

Alert thresholds, severities, debounce settings, counter thresholds, cooldowns, notification providers, and data-retention settings can all be configured from the dashboard.

Requirements

You need an ONT running compatible 8311 community firmware with its metrics endpoint reachable from the unRAID server.

The default metrics endpoint is:

https://192.168.11.1/cgi-bin/luci/8311/metrics

For optional advanced telemetry, the unRAID server must also be able to reach the ONT over SSH.

The dashboard does not create or manage the network path between unRAID and the ONT management interface. That connectivity must already exist.

UniFi Cloud Gateway Fiber

The project also includes optional reference scripts and documentation for maintaining persistent ONT management access when using a UniFi Cloud Gateway Fiber (UCG Fiber).

These scripts are not required by the dashboard and modify a WAN-side interface, so they should be reviewed and adapted to your network before use.

The documentation and reference scripts are available in the GitHub repository.

Installation

X-ONU-SFPP Dashboard is available through Community Applications on unRAID.

Search Community Applications for:

X-ONU-SFPP Dashboard

Docker image:

ghcr.io/jpetovello/x-onu-sfpp-dashboard:latest

Support

Please use this thread for:

• Installation help

• Configuration questions

• Upgrade problems

• ONT connectivity issues

• Dashboard behavior

• Alert and notification configuration

• General troubleshooting

• Feature questions

When reporting a problem, please include as much of the following as possible:

• unRAID version

• X-ONU-SFPP Dashboard version

• Relevant Docker/container logs

• Whether core telemetry is working

• Whether optional SSH monitoring is enabled

• Any relevant error messages

Please remove passwords, SSH credentials, notification tokens, webhook URLs, and other sensitive information before posting logs or screenshots.

Confirmed software bugs can also be reported through GitHub Issues.

Development Note

X-ONU-SFPP Dashboard has been developed with substantial AI-assisted software development. AI tools are used to assist with implementation, review, testing, documentation, and security analysis.

Project direction, requirements, real-world testing, validation, release decisions, and ongoing support are handled by the project maintainer.

The complete source code and development history are publicly available on GitHub.

Project Links

GitHub:
https://github.com/JPetovello/x-onu-sfpp-dashboard

Documentation / README:
https://github.com/JPetovello/x-onu-sfpp-dashboard#readme

GitHub Issues:
https://github.com/JPetovello/x-onu-sfpp-dashboard/issues

---

I maintain X-ONU-SFPP Dashboard and will use this thread for ongoing unRAID support and project-related questions.

Reserved for current support information

This post is reserved for current known issues, important upgrade notes, common fixes, and other support information that may change over time.

Current upgrade note

Existing installations upgraded from older versions that ran the container as root may have root-owned application data. If the container fails to start with:

sqlite3.OperationalError: attempt to write a readonly database

stop the container and, when using the default appdata path, run:

chown -R 99:100 /mnt/user/appdata/x-onu-dashboard

Then start the container again.

This changes ownership only and does not delete or reset the dashboard database or historical data.