mirror of
https://github.com/LibreQoE/LibreQoS.git
synced 2026-11-02 08:10:02 -06:00
2.8 KiB
2.8 KiB
Configure LibreQoS
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). - If you need to relaunch it after closing:
sudo apt remove libreqos sudo apt install ./{deb_url_v1_5}
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.
Advanced Configuration Reference
CLI-driven configuration, direct file editing, and deep reference content were moved here:
Configuration via Command Line
This section moved to Advanced Configuration Reference.
Network Hierarchy
This section moved to Advanced Configuration Reference.
Circuits
This section moved to Advanced Configuration Reference.