mirror of
https://github.com/LibreQoE/LibreQoS.git
synced 2026-10-26 06:40:05 -05:00
2.6 KiB
2.6 KiB
Configure LibreQoS
Page Purpose
Use this page for daily operations and WebUI configuration. Use Advanced Configuration Reference for direct file editing and CLI-heavy workflows.
Initial Configuration Via Setup Tool (From the .deb installer)
The setup tool configures initial bridge, interface, bandwidth, IP range, and WebUI user settings.
Notes:
- The setup tool is keyboard-driven (
Enterto select,Qto quit without saving).
Next Steps
After install, sign in to WebUI at http://your_shaper_ip:9123.
For most operators:
- Choose your operating mode: Operating Modes and Source of Truth
- Configure integration settings in WebUI: CRM/NMS Integrations
- Validate scheduler and shaping behavior in WebUI: LibreQoS WebUI (Node Manager)
Configuration Via Web Interface
Most day-to-day LibreQoS configuration is handled in WebUI (http://your_shaper_ip:9123/config_general.html).
Where in WebUI
- General settings:
Configuration -> General - Integration settings:
Configuration -> Integrations - Shaped devices editor:
Configuration -> Shaped Devices - Runtime operational validation:
WebUI (Node Manager)pages (dashboard/tree/flow/scheduler)
Operating Modes and Source of Truth
Read this first before production changes:
QoO (Quality of Outcome) profiles (qoo_profiles.json)
LibreQoS displays QoO as an estimate of internet quality based on latency and loss.
Where the file lives
<lqos_directory>/qoo_profiles.json
Selecting a profile
- WebUI: Configuration -> General -> QoO Profile
- Config file: set
qoo_profile_idin/etc/lqos.conf
Example:
# /etc/lqos.conf
qoo_profile_id = "web_browsing"
Applying changes
- Changes to
qoo_profiles.jsonare picked up automatically. - If you change
/etc/lqos.conf, restartlqosd.
Need CLI or File-Level Changes?
For direct file editing (/etc/lqos.conf, network.json, ShapedDevices.csv), overrides, and deeper topology/circuit reference material, use: