IntenseWebs/LibreQoS

0 Fork 0

mirror of https://github.com/LibreQoE/LibreQoS.git synced 2026-11-02 08:10:02 -06:00

Files

T

Robert Chacon 6648656b31 changes

2026-02-25 18:50:54 -07:00

1.3 KiB

Raw Blame History

Operating Modes and Source of Truth

LibreQoS supports two first-class operating modes.

Built-in Integrations (Recommended for Most Operators)

In this mode, your CRM/NMS is the source of truth and LibreQoS integration jobs produce shaping inputs.

Key behavior:

ShapedDevices.csv is regenerated by integration sync cycles.
network.json overwrite behavior depends on integration settings (for example always_overwrite_network_json).
Direct manual edits may be overwritten on the next scheduler refresh.

Custom Source-of-Truth

In this mode, your own scripts/systems generate network.json and ShapedDevices.csv.

Key behavior:

Your external workflow owns persistence.
WebUI edits are valid for quick operational changes.
Permanent changes should be made in your external source-of-truth workflow.

Mode Declaration Checklist (Before Go-Live)

Pick one primary source of truth.
Confirm which system can write production shaping inputs.
Confirm scheduler refresh behavior and overwrite cadence.
Document your hotfix workflow (WebUI, external editor, or both).
Do not maintain competing edits in multiple systems for the same objects.