Skip to content

Releases

2026.11.04.11

Choose a tag to compare

@alexphillips-dev alexphillips-dev released this 04 Nov 20:00

2026.11.04.11

This is the first stable release of the Data Volume Monitor continuation maintained by alexphillips-dev. It brings the development branch to the Stable (main) channel, with vnStat 2.14, the updated Data Volume Monitor artwork, clearer threshold settings, and the reliability fixes described below.

Data Volume Monitor tracks network interface usage in Unraid and can send notifications, stop/start selected Docker containers, disconnect/reconnect VM network links, or run custom functions when configured limits change state. Traffic remains interface based; container and VM matching supplies labels rather than independent application accounting.

Highlights

  • Updated backend: bundled vnstat, vnstatd, and vnstati upgraded from 2.12 to 2.14, built from verified upstream source with recorded build inputs and binary hashes.
  • Consistent threshold tables: eight primary rules and six secondary slots expose thresholds, units, and Docker/VM actions clearly. Primary settings now use the same table style as Secondary, with horizontal scrolling on narrow screens.
  • Clear threshold status: Disabled is red, Enabled is green, and invalid input is red. These labels describe the entered limit; notification and action switches remain separate.
  • More reliable monitoring: polling avoids overlapping requests, reports stale or unavailable data, and preserves the last successful measurements when a refresh fails.
  • Safer configuration and recovery: editor boundaries, save races, backup verification, custom storage paths, service errors, and concurrent notification checks have regression coverage.
  • Deliberate action testing: Service Check is diagnostic only. Test Configured Actions requires confirmation, and recorded failures can be retried after current configuration and threshold checks.
  • Stable and Development channels: installed version/channel information is visible in settings. Each channel keeps its own installer, package, and future-update URLs.

Installation and upgrade

For a new Stable installation, open Plugins → Install Plugin in Unraid and enter:

https://raw.githubusercontent.com/alexphillips-dev/Data-Volume-Monitor/main/plugin/dvm.plg

The manifest declares Unraid 6.8.3 or newer, and the packages target x86_64. The backend requires compatible host SQLite and GD libraries; it does not replace those host libraries. The declared minimum is not a claim of live testing on every Unraid version.

If you already use this continuation's Development channel, moving to Stable is an in-place channel switch. Follow the channel-switch instructions, including the destination-version check. Do not uninstall to switch channels: uninstall deletes plugin settings, backups, and traffic history. Development installations continue checking dev until deliberately switched.

If you use the original dwdvm plugin, follow Migration from the original plugin first. Stop the old service, copy configuration/scripts and the newest stopped database outside the old plugin's directories, and verify those independent backups before removal. The original and continued plugins must not be installed together. This release does not automatically migrate the old plugin identity.

After updating, refresh the settings page and check DVM Version / Channel and DVM Backend. Review saved interface selections, thresholds, and action switches before running configured actions.

Validation and host acceptance

The release is qualified with the repository's Linux validation entry point: Python regressions, PHP and JavaScript fixtures, syntax/ShellCheck checks, tracked-file checks, backend source/signature and binary checks, channel checks, exact package contents and permissions, and deterministic package rebuilding. The Python suite contains 142 tests; PHP and JavaScript fixtures run separately in the same validator.

Backend fixtures exercise all three executables, all six PNG output modes, the report formats, structured threshold boundaries, custom paths, and preservation of a database created by vnStat 2.12. Primary-table fixtures cover all eight rows and 48 fields through simulated Apply/reload. Browser simulations cover desktop and phone widths with light and dark fixture styles.

Automated fixtures do not establish live Unraid installation, native theme integration, real Docker/libvirt actions, or reboot persistence. Those observations remain separate in the Host acceptance checklist. Back up important history before migration or channel changes.

Documentation and support

Include plugin/channel, Unraid, and backend versions when reporting a problem. Remove credentials, server names, public IP addresses, and other private information from screenshots and logs.

Complete changes from the original version to this release

This cumulative list covers the continuation's work through 2026.11.04.11, rather than only the final development increment. The original baseline has manifest version 2026.10.16, plugin archive 2025.08.21, and backend vnstat-2.12-x86_64-1_slack14.2. Earlier upstream fixes remain documented in the manifest changelog.

Maintenance, identity, and artwork

  • Continued maintenance under alexphillips-dev/Data-Volume-Monitor, retaining required license/copyright notices.
  • Changed the active plugin identity and paths from dwdvm to dvm, including settings routes, configuration locations, scripts, downloads, updates, and support links.
  • Added installer conflict checks for the original plugin and Network Stats, which share vnStat service/database ownership.
  • Replaced active plugin artwork with the supplied Data Volume Monitor image and applied it to both the Plugins listing and Settings tile.
  • Removed the obsolete contributing file and kept local agent/tool configuration untracked.
  • Added ignore rules for environments, caches, credentials, runtime databases, logs, temporary/recovery files, and diagnostic exports while retaining required packages and checksums.
  • Preserved executable script modes for package installation and service execution.

Initial audit fixes

  1. Restricted configuration-editor access to supported files, checking path boundaries, traversal, symlinks, and file types.
  2. Distinguished unavailable/error threshold results from exceeded limits so failed queries do not trigger threshold actions or appear as confirmed healthy data.
  3. Fenced stale editor responses and save identity so switching files cannot save one file's content into another.
  4. Handled partial/failed paired saves, preserved previous contents and modes on handled failures, and supported intentional empty saves.
  5. Propagated service, wrapper, installer, reset, and package-removal failures before dependent operations proceed.
  6. Serialized concurrent notification checks with a real lock and covered overlap and lock-acquisition failure.
  7. Checked VM lookup, interface discovery, and network-link command results before reporting success.
  8. Evaluated all six custom thresholds and aggregated matching rules instead of losing later rules for the same interface/direction/period.
  9. Corrected combined interface/service filtering, exclusions, and PHP-to-JavaScript encoding.
  10. Preserved Docker/VM names, including spaces, during virtual-interface matching and checked peer/bridge matching boundaries.
  11. Corrected the custom-alarm 45-minute schedule across hour boundaries.
  12. Honored effective custom database and PID paths in service checks, persistence, restoration, editor guards, and resets; retained the selected storage location during resets.
  13. Preserved existing build deliverables when manifest validation, source reads, or handled publication steps fail, with rollback/recovery coverage.

Monitoring, reports, and display

  • Prevented overlapping polling requests and added finite request timeouts.
  • Retained the last complete measurements after failed or partial refreshes, with visible stale/unavailable status and recovery behavior.
  • Prevented late responses from updating pages after navigation and resumed polling after back/forward cache restoration.
  • Separated valid traffic measurements from threshold-only query errors and covered missing interface/service data.
  • Escaped interface/service names and report text, retained complete filtered labels, and used safe generated image names and image URL handling.
  • Added content-based cache invalidation for shipped UI scripts.
  • Kept the traffic overview visible while grouping detailed reports in a labeled section that starts collapsed.
  • Added spacing between footer inbound/outbound usage and colored the direction arrows.
  • Kept primary and secondary threshold/action controls readable and editable when limits are disabled.
  • Added live red Disabled, green Enabled, and red Invalid labels, including whole-number and unsigned 64-bit boundary validation.
  • Converted Primary Interface Thresholds and User Actions into eight table rows, preserving all 48 field identities, saved values, unit choices, and workload selections.
  • Added accessible labels and a keyboard-focusable horizontal scroll region to the primary table.

Configuration, persistence, and action outcomes

  • Preserved saved interfaces and Docker/VM targets when discovery is empty or fails, identi...
Read more