Releases: LibreQoE/LibreQoS
v2.1
Summary
LibreQoS v2.1 is focused on making daily operation easier for Internet Service Providers. The release improves visibility in the Web UI, expands integration compatibility, makes first-run and login behavior clearer, and continues the shaping/runtime work needed for safer reloads and larger deployments.
In practical terms, this release is about helping ISPs spend less time guessing what LibreQoS is doing, less time fighting integration edge cases, and more time using LibreQoS as an operational tool.
| Flow Globe | ASN Analysis |
|---|---|
 |
 |
| Site Map | Flow Sankey |
|---|---|
 |
 |
Insight and API
v2.0 also continues to expand optional paid capabilities:
- Insight workflows are more mature
- API and overrides support are broader
- support-ticket and entitlement-related workflows are improved
| Insight Executive Dashboard | Insight Site Rankings |
|---|---|
 |
 |
| Insight Circuit Timeline | Insight Circuit ASN View |
|---|---|
 |
 |
You can try a demo of LibreQoS insight here: https://insight.libreqos.com/training/shaper.html
These features remain optional, while the core local shaping and WebUI operator workflow continues to be the center of LibreQoS.
Important Note
Starting in v2.0, mapped-circuit ingest depends on valid Insight license state.
Without a valid Insight subscription/license, LibreQoS reads only the first 1000 valid mapped circuits into active shaping state. This also applies when Insight is expired or otherwise invalid.
If this affects your deployment, review the upgrade and Insight documentation before rollout.
Get Started
If you are new to LibreQoS v2.0 or planning your upgrade, start here:
v2.0
LibreQoS v2.0
LibreQoS v2.0 is here.
This release makes LibreQoS easier to operate, easier to understand, and much more useful for day-to-day network work. Now users can see more of what is happening across the network, troubleshoot subscriber issues with better tools, and work from a much stronger local WebUI.
In Memory of Dave Täht
This release includes many capabilities that reflect ideas and direction long championed by our late colleague, Dave Täht.
Dave’s work helped shape the understanding of bufferbloat and the importance of latency under load across the networking community. His influence continues to guide both LibreQoS and the broader effort to improve Internet quality.
As we approach the anniversary of his passing on April 1st, we would like to acknowledge his contributions and the lasting impact he has had on this work.
What’s New
- Now users can work from a much stronger WebUI with better dashboards, better network views, and more useful circuit pages.
- Now users can see the network as a hierarchy with improved Tree views, better topology handling, and clearer node behavior.
- Now users can troubleshoot subscriber issues with
Queue Dynamics,Traffic Flows,Flow Sankey, retransmits, RTT visibility, and Quality of Outcome insights. - Now users can use richer map and traffic views, including
Site Map,Flow Globe, andASN Analysis. - Now users can work with clearer CRM/NMS integration workflows and a better-defined source of truth for shaping data.
- Now users can use built-in integrations for:
- UISP
- Splynx
- Netzur
- VISP
- WISPGate
- Powercode
- Sonar
- Now users can benefit from more mature shaping behavior with TreeGuard, StormGuard improvements, better queue management, and stronger handling for fractional plans.
- Now users can use improved scheduler health visibility and urgent issue reporting to spot operational problems faster.
- Now users can install and upgrade with stronger packaging, runtime fixes, and better Ubuntu 24.04 guidance.
| Flow Globe | ASN Analysis |
|---|---|
|
|
| Site Map | Flow Sankey |
|---|---|
|
|
Insight and API
v2.0 also continues to expand optional paid capabilities:
- Insight workflows are more mature
- API and overrides support are broader
- support-ticket and entitlement-related workflows are improved
| Insight Executive Dashboard | Insight Site Rankings |
|---|---|
|
|
| Insight Circuit Timeline | Insight Circuit ASN View |
|---|---|
|
|
You can try a demo of LibreQoS insight here: https://insight.libreqos.com/training/shaper.html
These features remain optional, while the core local shaping and WebUI operator workflow continues to be the center of LibreQoS.
Important Note
Starting in v2.0, mapped-circuit ingest depends on valid Insight license state.
Without a valid Insight subscription/license, LibreQoS reads only the first 1000 valid mapped circuits into active shaping state. This also applies when Insight is expired or otherwise invalid.
If this affects your deployment, review the upgrade and Insight documentation before rollout.
Get Started
If you are new to LibreQoS v2.0 or planning your upgrade, start here:
v1.4
LibreQoS v1.4 Change Summary
Version 1.4 is a huge milestone. A whole new back-end, new GUI, 30%+ performance improvements, support for single-interface mode.
Some Statistics
- 1,097 Commits since 1.3.1
- 43,282 Lines of Code
- 16,917 lines of Rust
- 16,508 lines of HTML & JavaScript
- 7,087 lines of Python
- 2,770 lines of C
Peak Performance (So Far)
- Tested single-stream performance of just under 10 gbit/s on a 16-core Xeon Gold (single interface architecture, using 8 cores for each direction). The flow was shaped with Cake, and retained good (<10 ms RTT latency) performance.
- Tested 25 gbit/s total throughput on the same system. CPU was not saturated---we didn't have a bigger network to test!
- Running live at ISPs with 11 gbit/s of real customer performance and plenty of room to grow.
New Architecture
- Rust-based back-end provides:
lqosd- a daemon that manages:- Loading/setup/unloading eBPF programs.
- Gathers statistics directly from eBPF.
- Provides a local "bus" for transporting data between components.
- Sets "tunables", replacing the need for a separate offloading service.
lqtop- a console-based utility for viewing current activity.lqos_node_manager- a web-based GUI that:- Monitors current activity.
- Monitors system status.
- Provides "best/worst" summaries of RTT.
- Provides visibility into the working of queues.
- Categorizes traffic to match your network hierarchy, letting you quickly find the bottlenecks.
- Let's you browse and search your shaped devices.
- Lists "unknown IP addresses" that are passing through the shaper but do not have a rule associated.
- Allows you to view and edit the LibreQoS configuration.
lqos_python- provides Python access to the bus system.lqos_setup- builds enough configuration files to get you started.lqos_users- authentication for the GUIs.
- High-performance Python script:
- Batches TC commands for fast execution.
- Batches bus-transactions to associate IP subnets with users for fast execution.
- Improved scheduler for InfluxDB graphing.
High Performance Bridge (Bifrost)
- Optionally replace the Linux bridge system with an XDP-based bridge accelerator.
- Throughput is 30% higher in this mode.
Packet and Flow Analysis (Heimdall)
- Viewing a circuit in the web UI displays a summary of IP traffic flows for that circuit.
- A "capture" button will capture packet headers, and allow nanosecond-level analysis of traffic data.
- You can download the packet captures in
libpcapformat, for analysis in Wireshark and similar tools. - Configure the capture delay in
/etc/lqos.conf
Single-interface Mode
- Operate with a single network interface and VLANs for "in" and "out".
Graphs
- Graph current throughput, shaped and unshaped.
- Graph CPU and RAM performance.
- Graph individual Cake shaper tins, backlog, delays.
- TCP "round trip time" histogram showing overall network latency performance.
- Per-network node traffic graph.
- Per-network node RTT latency histogram, to let you zero-in on troublespots.
Integration Improvements
- UISP integration now uses a full cost-based spanning tree (Dijkstra) to determine node placement in topology. #328
Miscellaneous
build_rust.shbuilds the entire package from a Git update, with minimal (<1 second) downtime.build_dpkg.shassembles the entire system into an Ubuntu/Debian.debinstaller.- Sample
.servicefiles forsystemdintegration. - Real-time adjustment to tunables.
- Redact text into Klingon to allow screenshots without sharing customer data.
- Preliminary support for reading IP data inside MPLS packets, as long as they are ordered "VLAN->MPLS->VPLS" and not the other way around.
- Automatically trim network trees that exceed 9 levels deep.
- Very accurate timing functions for better statistics.
- Greatly improved documentation.
- Improved rejection of TCP round-trip-time outliers (from long-polled connections).
- Improved Spylnx and UISP integrations.
Better Distribution
This is in alpha testing. It has worked on some test setups, but needs production testing.
Installation via apt-get and LibreQoS's own repo. Add the libreqos repo, and you can use apt-get to install/update the traffic shaper. This doesn't get you the development toolchain.
sudo echo "deb http://stats.libreqos.io/ubuntu jammy main" > /etc/apt/sources.list.d/libreqos.list
wget -O - -q http://stats.libreqos.io/repo.asc | apt-key add -
apt-get update
apt-get install libreqosYou will be asked some questions about your configuration, and the management daemon and webserver will automatically start. Go to http://<your_ip>:9123/ to finish installation.
Gallery
Node Manager - Dashboard
The node manager displays current activity on your network
Node Manager - Circuit View
Find out exactly what's going on inside each circuit, monitoring all of the queue stats - you can even view the details of each category tin
Node Manager - Flow Analysis
Analyze what's going on for a specific client, viewing real-time traffic flow data. No need to run torch or equivalent on their router. Ideal for finding connectivity problems.
Node Manager - Packet Capture
Capture traffic and analyze per-packet in an intuitive, zoomable traffic analysis system. You can view down to nanosecond granularity to find performance problems, and see what's really going on with your traffic. Click "Download PCAP Dump" to analyze the same data in Wireshark.
Long Term Statistics (LTS)
LibreQoS' new Long Term Stats (LTS) system aggregates and graphs LibreQoS statistics for fast, efficient troubleshooting and network analysis. There is a free 30-day trial, after which the rate is $0.30 USD per shaped subscriber. You can enroll in the 30-day free trial by clicking "Start Stats Free Trial" in the top-right corner of the local LibreQoS GUI.
Long Term Statistics - Dashboard
Long Term Statistics - Report - All APs
Long Term Statistics - Report - All Sites
Long Term Statistics - Shaper Node
