DOCSight v2026-07-16.1

Highlights

• Adds a searchable in-app DOCSIS glossary with alphabetical browsing, contextual term links, accessible mobile navigation, and localized content across the supported UI languages.
• Adds monitoring support for the Arris SURFboard SB6183.
• Improves signal interpretation with clearer theoretical channel-capacity context and corrected CODA-56 OFDMA report-power handling.
• Makes PDF reporting more dependable by wrapping long issue lists and remembering customer details for future reports.
• Keeps valid admin sessions available across browser restarts.
• Hardens external endpoint checks and diagnostic error handling while updating security-sensitive dependencies.

Changelog

Added

• In-app DOCSIS glossary integrated into the main navigation and contextual help links.
• Searchable, alphabetically sorted glossary terms with focused summaries and explanations.
• Localized glossary content across all supported UI languages.
• Arris SURFboard SB6183 modem driver support.

Changed

• Refined glossary terminology, domain semantics, accessibility, and optional media contracts.
• Clarified theoretical channel-capacity estimates and their relationship to real throughput.
• Saved report customer details as reusable report settings.
• Preserved valid admin sessions when the browser is closed and reopened.

Fixed

• Corrected CODA-56 OFDMA per-1.6 MHz report-power parsing.
• Prevented long issue lists from overflowing PDF report layouts.
• Restricted Speedtest connection checks to the configured endpoint.
• Removed sensitive modem response details from logs and sanitized connection-probe fallback errors.
• Updated Click and Pillow to secure dependency versions.

Docker image

• ghcr.io/itsdnns/docsight:v2026-07-16.1
• ghcr.io/itsdnns/docsight:latest

Full diff: v2026-07-05.1...v2026-07-16.1

DOCSight v2026-07-05.1

Highlights

• Settings now surface live modem and MQTT connection status, so operators can see connection health directly where they configure integrations.
• Settings navigation and layout were tightened across desktop, tablet, and mobile: grouped sidebar navigation, preserved browser-back state, visible mobile support actions, and collapsible notification channel cards.
• Security and accessibility improvements cover masked saved admin passwords, better icon-only button labels, and mobile drawer navigation behavior.
• Settings consistency improved with shared form styling for Smart Capture, clearer broadband-measurement toggle naming, corrected toast states, and deduplicated small-button styles.
• Internal module, theme, and maintainer-notice loading paths were simplified while preserving the public extension contracts.
• Settings coverage was expanded with additional browser/E2E and server-side regression tests.

Changelog

Added

• Live modem connection status in Settings.
• Live MQTT connection status in Settings.
• Additional settings page browser/E2E coverage and theme regression coverage.

Changed

• Grouped settings sidebar navigation and restored browser history behavior between settings sections.
• Made notification channel cards collapsible.
• Improved tablet-width settings layout and kept mobile settings support visible.
• Applied shared form styling to Smart Capture settings.
• Clarified related broadband-measurement toggle names.
• Deduplicated settings small-button styles and built-in theme tokens.
• Simplified built-in module discovery, module entry-point loading, appearance theme registry loading, and local maintainer notices.
• Refocused defensive documentation checks.

Fixed

• Corrected settings toast states.
• Masked the saved admin password in Settings.
• Improved accessibility for icon-only settings controls and mobile navigation.

Docker images

• ghcr.io/itsdnns/docsight:v2026-07-05.1
• ghcr.io/itsdnns/docsight:latest

Full diff: v2026-07-03.1...v2026-07-05.1

DOCSight v2026-07-03.1

Highlights

• Strengthened DOCSIS evidence traceability: saved snapshots now carry provenance, signal events link back to current and previous snapshots, and replay fixtures cover the main evidence paths.
• Improved signal interpretation across reports, events, analyzer output, and modulation capacity context with shared DOCSIS channel semantics.
• Hardened local storage for long-lived self-hosted installs with explicit schema-version tracking, deterministic migrations, incident-window retention protection, and surfaced snapshot persistence failures.
• Improved runtime safety with broader route-level authentication coverage, faster frequent API token validation, safer static asset versioning for PWA upgrades, opt-in release update checks, and redacted webhook endpoint logging.
• Refreshed Docker-related GitHub Actions pins after verifying the final main build, tests, CodeQL, Pages deployment, Docker image workflow, and full browser E2E gate.

Added

• Replayable DOCSIS snapshot and case fixtures for analyzer, event, and evidence-checklist regression coverage.
• Snapshot analysis provenance metadata.
• Event-to-snapshot traceability documentation and data-contract coverage.
• Schema-version and retention evidence contracts in DATA_CONTRACT.md.

Fixed

• Demo snapshots remain purgeable during cleanup.
• Unavailable DOCSIS measurements are preserved instead of being collapsed into misleading values.
• Signal event generation avoids comparing power/SNR when either side is missing.
• Snapshot persistence failures now surface as operational failures instead of silent evidence gaps.
• Webhook notifier logs no longer expose endpoint details.

Changed

• DOCSIS channel-family classification is shared across analyzer, events, reports, and modulation checks.
• Signal events are seeded from the latest saved snapshot after restart.
• Retention cleanup preserves snapshots and events inside explicit incident windows.
• Frequent API token validation uses a faster path.
• Release update checks are opt-in.
• Static assets are versioned for safer PWA upgrades.
• Runtime and maintenance checks were hardened.

Dependencies and CI

• Bumped pypdf from 6.13.3 to 6.14.2.
• Bumped actions/setup-python from 6.2.0 to 6.3.0.
• Bumped Docker workflow actions: docker/build-push-action, docker/metadata-action, docker/login-action, docker/setup-buildx-action, and docker/setup-qemu-action.

Docker images

• ghcr.io/itsdnns/docsight:v2026-07-03.1
• ghcr.io/itsdnns/docsight:latest

Full diff: v2026-06-22.1...v2026-07-03.1

DOCSight v2026-06-22.1

Highlights

• Added the Evidence Journey, a guided checklist for collecting ISP-ready troubleshooting evidence.
• Added passive self-hosted doctor diagnostics for local configuration, storage, secret, database, and integration checks.
• Fixed community module storage defaults so Docker installs use the persistent /data/modules path.
• Improved modem evidence fidelity, including CODA OFDMA per-channel report power and wrapped CM3500 service-flow rates.
• Reduced maintenance and static asset surface while preserving user-visible behavior: smaller icon bundle, slimmer offline caching, fewer generated translation files, unused public assets removed, and font leftovers removed.
• Simplified built-in module, theme, threshold, Smart Capture, collector, storage, and modem-driver internals without changing supported workflows.

Added

• Evidence Journey checklist for troubleshooting evidence collection.
• Connection Monitor latency evidence in the Evidence Journey.
• Self-hosted doctor diagnostics with a passive, local-first default.
• Data contract documentation and clearer local-first trust guidance.

Fixed

• Community module installs now default to persistent module storage for Docker deployments.
• CODA-4680 OFDMA power uses the per-channel report-power value when available.
• CM3500 service-flow rate parsing handles wrapped counters.
• Evidence Journey edge cases were hardened.
• OFDM channel quality is labeled as MER where appropriate.

Changed

• Module locale maintenance files were reduced while keeping runtime translations available.
• Built-in modules, themes, threshold profiles, storage composition, collectors, and driver aliases now use simpler internal registration paths.
• Smart Capture execution wiring and speedtest adapter tests were consolidated.
• PWA offline static caching was simplified.
• The bundled icon set is now much smaller.
• Core translation templates are generated on demand instead of stored as a large generated file.
• Vodafone driver crypto now uses the existing AES-CCM implementation, and PBKDF2 helper usage was simplified.

Removed

• Unused public screenshots and image leftovers.
• Unused local Inter font files.
• Unused static JavaScript helpers.
• Old proof-pack generation script from the runtime repository.
• Unused module secret, module driver, and collector registry plumbing.

Dependencies and CI

• Bumped selected Python dependencies, including pypdf, aiohttp, beautifulsoup4, cryptography, and pytest.
• Bumped actions/checkout.
• Removed pycryptodome from the runtime dependency path.

Docker images

• ghcr.io/itsdnns/docsight:v2026-06-22.1
• ghcr.io/itsdnns/docsight:latest

Full diff: v2026-06-10.1...v2026-06-22.1

DOCSight v2026-06-10.1

Highlights

Raw ping logs for ISP evidence

Connection Monitor now exposes the raw ping log path more clearly:

• Added raw ping log export for packet-level ISP evidence.
• Made the raw ping log reachable on mobile without deep scrolling.
• Kept the pin-day action separate from time-range controls so range navigation stays stable.

Cleaner dashboard and view headers

Dashboard subviews and action headers now share a more consistent layout:

• Normalized page headers across views.
• Aligned event, channel, and Connection Monitor header actions.
• Improved the Home KPI card anatomy, including the Speed card action.

DOCSIS signal clarity

This release tightens DOCSIS wording and parsing around newer channel types:

• Parses CGA OFDMA modulation correctly.
• Labels DOCSIS 3.1 OFDM channel quality as MER instead of SNR in Channel Details.
• Keeps SC-QAM channel details labeled as SNR.

Smart Capture guardrails

Smart Capture now applies action-specific caps before triggering Speedtest Tracker, reducing the chance that a noisy signal event storm starts too many external speed tests.

Maintenance refresh

Dependency and workflow actions were refreshed, including aiohttp and the pinned Docker/GitHub Actions build steps.

Changelog

Added

• Added raw ping log export for Connection Monitor.

Changed

• Normalized view page headers.
• Aligned Connection Monitor header controls.
• Aligned event and channel header actions.
• Kept the Connection Monitor pin action outside the range picker.
• Polished Home KPI card anatomy.
• Improved the Home Speed KPI card action.
• Updated DOCSIS 3.1 OFDM channel-details wording from SNR to MER.

Fixed

• Fixed raw ping log visibility on mobile.
• Fixed Smart Capture Speedtest Tracker action caps.
• Fixed CGA OFDMA modulation parsing.

Maintenance

• Bumped aiohttp from 3.13.5 to 3.14.0.
• Bumped docker/setup-qemu-action from 4.0.0 to 4.1.0.
• Bumped docker/login-action from 4.1.0 to 4.2.0.
• Bumped docker/metadata-action from 6.0.0 to 6.1.0.
• Bumped actions/checkout from 6.0.2 to 6.0.3.
• Bumped docker/setup-buildx-action from 4.0.0 to 4.1.0.

Docker image

The release image is published as:

• ghcr.io/itsdnns/docsight:v2026-06-10.1
• ghcr.io/itsdnns/docsight:latest

Compare

Full diff: v2026-06-04.1...v2026-06-10.1

DOCSight v2026-06-04.1

Highlights

New modem coverage

DOCSight can now collect from two additional modem families:

• Added a Hitron CODA-4680 driver with hardened reauthentication handling.
• Added a Sercom DM1000 driver, including follow-up fixes for browser login navigation and login payload handling.
• Removed temporary Sercom DM1000 diagnostics after the driver fixes landed.

More trustworthy DOCSIS trends and counters

This release tightens how DOCSight handles long-running modem counters and chart ranges:

• Counter rollovers and aggregate counter wraps are unwrapped before they skew trends.
• Stable DOCSIS error trend ranges were fixed.
• Chart axis time labels were normalized for clearer trend reading.

Signal and modulation clarity

Dashboard and channel views now present signal details with less ambiguity:

• Modulation range labels were normalized.
• KPI family health is aligned with modulation state.
• Modulation values are colored individually while preserving plain modulation prefixes.
• Unused channel controls stay hidden.

Evidence and reporting fixes

Incident and complaint evidence is safer to reuse:

• Customer details are preserved in complaint PDFs and incident reports.
• A dependency refresh updates pypdf to 6.12.2.

Changelog

Added

• Added a Hitron CODA-4680 modem driver.
• Added a Sercom DM1000 modem driver.
• Added Sercom DM1000 diagnostics during driver validation.

Changed

• Hardened CODA-4680 reauthentication handling.
• Aligned KPI family health with modulation state.
• Colored modulation values individually.
• Normalized modulation range labels.
• Normalized chart axis time labels.
• Removed temporary Sercom DM1000 diagnostics after validation.

Fixed

• Fixed Sercom DM1000 login navigation.
• Fixed Sercom DM1000 browser login flow.
• Fixed Sercom DM1000 browser login payload handling.
• Fixed DOCSIS counter rollover and aggregate counter wrap handling.
• Fixed stable DOCSIS error trend ranges.
• Fixed complaint PDF customer detail preservation.
• Fixed incident report customer details.
• Restored plain modulation prefixes.
• Simplified KPI modulation labels.
• Hid unused channel controls.

Maintenance

• Bumped pypdf from 6.12.0 to 6.12.2.

Docker image

The release image is published as:

• ghcr.io/itsdnns/docsight:v2026-06-04.1
• ghcr.io/itsdnns/docsight:latest

Compare

Full diff: v2026-05-27.1...v2026-06-04.1

DOCSight v2026-05-27.1

Highlights

Home dashboard signal-family cards

The Home dashboard now groups signal health by DOCSIS signal families instead of mixing channel types into one average. Downstream and upstream cards show clearer SC-QAM, OFDM, and OFDMA context, including modulation details, health ranges, and per-family guidance.

Several follow-up refinements landed in this release:

• Restored OFDMA power KPI detection for active upstream OFDMA channels.
• Clarified that signal-family KPIs are active-channel averages.
• Improved SNR/MER basis handling for OFDM channels.
• Restored and aligned Home KPI range bars.
• Stacked modulation details consistently beneath status text.
• Normalized time range controls.

Channels and trend clarity

Channel and trend views received targeted fixes and new diagnostics:

• Added temperature overlays to Channels charts.
• Tightened Channels chart temperature behavior and follow-up polish.
• Fixed BQM lost-poll chart rendering.
• Filled the DS SNR trend chart area correctly.
• Kept the correlation event filter popover above the timeline.

Analysis filters and signal scoring fixes

Analysis and signal health handling are more precise:

• Added correlation event filtering by severity.
• Fixed modulation health and channel-loss warnings.
• Treats DOCSIS 3.0 downstream 64QAM as healthy.
• Translated downstream modulation dashboard issue text.
• Shortened missing-modulation values for clearer dashboard display.

Security, language, and settings polish

• Secured module-owned config secrets.
• Added a European language pack.
• Kept instant settings saves silent.
• Aligned monitor-disabled state and trend fills.

Special thanks

A special thank you to @NonCertus for the thorough QA, the issues over the last few days, and the bug reports and feedback that helped shape this release.

Changelog

Added

• Added signal-family Home dashboard cards for DOCSIS channel families.
• Added Channels chart temperature overlays.
• Added severity filtering for correlation events.
• Added a European language pack.

Changed

• Home KPI cards now present active-channel averages with clearer family-specific context.
• Home SNR/MER handling now distinguishes OFDM MER data from SC-QAM SNR more clearly.
• Modulation details and KPI range bars are aligned more consistently across Home cards.
• Time range controls were normalized.
• Channels chart temperature behavior was refined.

Fixed

• Restored the US POWER (OFDMA) Home KPI when active upstream OFDMA channels are present.
• Restored Home signal-family card ranges.
• Fixed BQM lost-poll chart rendering.
• Fixed DS SNR trend fill rendering.
• Fixed correlation event filter popover stacking above the timeline.
• Fixed modulation health and channel-loss warning behavior.
• Fixed DOCSIS 3.0 downstream 64QAM health classification.
• Fixed translated downstream modulation dashboard issue text.
• Fixed monitor-disabled visual state and trend fills.
• Kept instant settings saves silent.

Security

• Secured module-owned config secrets.

Docker image

The release image is published as:

• ghcr.io/itsdnns/docsight:v2026-05-27.1
• ghcr.io/itsdnns/docsight:latest

Compare

Full diff: v2026-05-22.1...v2026-05-27.1

DOCSight v2026-05-22.1

Highlights

Apprise notification sidecar

DOCSight can now send alerts through an optional Apprise API sidecar. DOCSight still decides when an alert should fire, including severity filters, per-event toggles, cooldowns, event context, and test notifications. Apprise handles where those alerts go, such as Telegram, Matrix, ntfy, Gotify, Slack, Pushover, email, and other Apprise-supported targets.

See docs/notifications-apprise.md for setup notes, Docker Compose guidance, privacy notes, and provider examples.

PWA Web Push notifications

Installed DOCSight PWAs and supported browsers can now subscribe to local Web Push alerts. This adds browser/device notifications to the same DOCSight notification pipeline as webhooks and Apprise, with VAPID configuration, subscribe/unsubscribe controls, short push payloads, and stale subscription cleanup.

See docs/notifications-pwa-web-push.md for requirements and troubleshooting.

Notification control and safety

Notification handling is more precise and safer by default:

• Per-severity notification cooldowns for individual event types.
• Instant save behavior for settings toggles.
• Redacted PWA subscription validation failures.
• Generic client-facing errors for unexpected notification test exceptions, with details kept out of API responses.
• Additional acceptance and regression coverage for Apprise, PWA push, and notification error boundaries.

Dashboard and signal clarity

The dashboard and channel views received several signal-quality refinements:

• Home modulation context is now exposed more clearly.
• Home modulation rows and layout are aligned.
• Dashboard KPI status now matches the underlying averages.
• The SNR card basis is clarified.
• 30-day modulation chart x-axis labels are bounded.
• Channels modulation chart labels are corrected.
• Dashboard meta text and mobile meta popovers have been tightened.

Speedtest Tracker HTTPS support

Speedtest Tracker integrations now support self-signed HTTPS setups, with matching documentation for the option.

Changelog

Added

• Added optional Apprise API sidecar delivery for notifications.
• Added browser/PWA Web Push notifications with VAPID settings and per-browser subscription controls.
• Added per-severity notification cooldowns.
• Added Home modulation context and improved modulation display coverage.
• Added documentation for Apprise, PWA Web Push, and Speedtest Tracker self-signed HTTPS setups.

Changed

• Settings toggles now save instantly.
• Dashboard KPI status now aligns with average-based health state.
• Home modulation rows, chart labels, dashboard metadata, and mobile popover positioning were refined.
• Notification settings UI now separates webhook, Apprise, PWA push, and per-event cooldown controls.
• Test dependency pins and CI dependencies were refreshed.

Fixed

• Baseline handling for cumulative error counters.
• Speedtest Tracker self-signed HTTPS support.
• 30-day modulation chart x-axis overflow.
• PWA subscription validation error redaction.
• Notification test exception sanitization to avoid returning raw exception details through API responses.

Maintenance

• Updated requests, pypdf, idna test pins, and docker/build-push-action.
• Expanded unit and E2E coverage across notifications, settings, charts, dashboard, modem collection, Speedtest, static contracts, and web index behavior.

Docker image

The release image is published as:

• ghcr.io/itsdnns/docsight:v2026-05-22.1
• ghcr.io/itsdnns/docsight:latest

Compare

Full diff: v2026-05-18.1...v2026-05-22.1

v2026-05-18.1

Highlights

• Updated the dashboard overview with a cleaner, more modern layout that puts modem health, signal trends, and key actions closer to the top of the page.
• Added clearer metric range visuals so downstream, upstream, power, SNR, and latency readings are easier to scan at a glance.
• Improved dashboard responsiveness across phone, tablet, and desktop widths, including tighter action wrapping and overflow fixes for dense cards.
• Strengthened dashboard accessibility with keyboard-friendly controls, better chart labels, clearer collapsible DOCSIS sections, and reduced-motion handling.
• Refreshed the Connection Monitor detail view with stronger pinned-day handling, cleaner no-data states, improved availability labels, and accessible traceroute controls.
• Fixed correlation timeline and Event Log details so channel metadata and filtered timeline views stay aligned.
• Refreshed the public landing page, proof-pack screenshots, README hero visuals, and self-hosted directory materials with the current DOCSight dashboard.
• Bumped urllib3, requests, and pypdf to current pinned versions.

Docker

The image is published to GHCR for:

• ghcr.io/itsdnns/docsight:latest
• ghcr.io/itsdnns/docsight:v2026-05-18.1

v2026-05-08.1

Highlights

• Preserved unsupported DOCSIS error counters as null through storage, API, dashboard, reports, exports, Speedtest, comparison, and event paths, while keeping real supported 0 values visible.
• Hid unsupported DOCSIS error charts and timeline text in Before/After Comparison and Unified Timeline views so unsupported modem counters no longer look like clean zero-error readings.
• Fixed Modulation Low-QAM trend and distribution semantics, including weighted exposure, drilldown day bars, a 0-100% trend axis, visible-sample denominator alignment, and clearer localized hints.
• Refined DOCSIS 3.1 upstream coloring so 64QAM and below read as Low-QAM, 128QAM reads as reduced, and 256QAM+ reads as healthy.
• Added DOCSIS 3.0 upstream-specific modulation colors so 64QAM reads healthy, 32QAM reads reduced, and 16QAM or lower reads low.
• Made the Unified Timeline sticky header opaque so rows no longer bleed through while scrolling.
• Cleaned up issue template routing for bug reports and security links.
• Bumped cryptography to 48.0.0 and kept pinned production/test requirements in sync.

Docker

The image is published to GHCR for:

• ghcr.io/itsdnns/docsight:latest
• ghcr.io/itsdnns/docsight:v2026-05-08.1