changes

conf.py

@@ -38,7 +38,7 @@ def ultimateReplace(app, docname, source):
     source[0] = result
 
 ultimate_replacements = {
-    "{deb_url_v1_5}" : "libreqos_1.5-RC3.202512062019-1_amd64.deb"
+    "{deb_url_v1_5}" : "libreqos_2.0-beta-1.202603171351-1_amd64.deb"
 }
 
 def setup(app):

docs-es/v2.0/api-es.md

@@ -5,8 +5,9 @@
 El servicio `lqos_api` (API del nodo) requiere una suscripción activa a LibreQoS Insight.
 
 Esto es independiente de los límites base de shaping:
-- El shaping base de LibreQoS puede operar hasta 1000 suscriptores sin Insight.
-- Límites superiores dependen de una licencia Insight activa.
+- `ShapedDevices.csv` puede contener entradas ilimitadas.
+- Sin una suscripción/licencia Insight válida, LibreQoS admite solo los primeros 1000 circuitos mapeados válidos al estado de shaping activo.
+- Conteos superiores de circuitos mapeados dependen de una licencia Insight activa.
 
 ## Fuente de verdad y pruebas
 

docs-es/v2.0/insight-es.md

@@ -124,15 +124,27 @@ Notas operativas:
 
 ### Límites de circuitos mapeados y estado de licencia
 
-Compilaciones recientes aplican límites de circuitos mapeados según estado de licencia.
+`ShapedDevices.csv` puede contener entradas ilimitadas. En compilaciones v2.0 actuales, la admisión al estado de shaping activo depende del estado válido de la licencia Insight.
 
-Si su nodo está sin licencia/válido, LibreQoS puede aplicar un límite predeterminado de circuitos mapeados. Cuando se excede, los logs incluyen mensajes como:
+Sin una suscripción/licencia Insight válida, LibreQoS admite solo los primeros 1000 circuitos mapeados válidos al estado de shaping activo. Los circuitos mapeados válidos adicionales permanecen fuera del shaping activo hasta que se restaure una licencia Insight válida.
 
-- `Mapped circuit limit reached`
-- `Bakery mapped circuit cap enforced`
+Una suscripción/licencia Insight válida habilita conteos de circuitos mapeados por encima del límite predeterminado de 1000.
+
+El comportamiento predeterminado del límite de 1000 aplica cuando Insight está:
+- ausente
+- expirado
+- inválido por cualquier motivo
+- operando con estado local de grant offline inválido
+
+Cuando se alcanza el límite, los operadores normalmente verán:
+- una advertencia prominente en WebUI
+- un indicador de uso en la navegación izquierda mostrando cercanía al límite
+- mensajes de `lqosd` como:
+  - `Mapped circuit limit reached`
+  - `Bakery mapped circuit cap enforced`
 
 Cuando ocurra:
 
 1. Revise estado de licencia Insight en la UI.
 2. Revise `journalctl -u lqosd` para conteos requested/allowed/dropped.
-3. Verifique si la cantidad de circuitos mapeados excede su licencia.
+3. Verifique si el nodo está operando con el límite predeterminado de 1000 circuitos mapeados porque el estado actual de Insight/licencia es inválido.

docs-es/v2.0/quickstart-es.md

@@ -29,6 +29,28 @@ wget https://download.libreqos.com/{deb_url_v1_5}
 sudo apt install ./{deb_url_v1_5}
 ```
 
+```{note}
+`ShapedDevices.csv` puede contener entradas ilimitadas. En v2.0, el shaping activo sin una suscripción/licencia Insight válida está limitado a los primeros 1000 circuitos mapeados válidos. Vea [Comportamiento de licenciamiento de Insight](insight-es.md#límites-de-circuitos-mapeados-y-estado-de-licencia).
+```
+
+### Hotfix de Ubuntu 24.04 si la instalación del `.deb` se detiene
+
+En hosts Ubuntu 24.04 afectados que usan `systemd-networkd`, la instalación del `.deb` puede detenerse y mostrar un mensaje requiriendo el hotfix. Esto es esperado.
+
+Si eso ocurre, ejecute:
+
+```bash
+sudo /opt/libreqos/src/systemd_hotfix.sh install
+sudo reboot
+```
+
+Después del reinicio, reanude la instalación:
+
+```bash
+cd ~
+sudo apt install ./{deb_url_v1_5}
+```
+
 5. Abra WebUI en `http://your_shaper_ip:9123`.
 
 ## 2) Puerta de salud en 10 minutos (obligatoria antes del piloto)

docs-es/v2.0/troubleshooting-es.md

@@ -186,6 +186,20 @@ Si ve mensajes como:
 
 LibreQoS está aplicando un límite de circuitos mapeados.
 
+`ShapedDevices.csv` puede contener entradas ilimitadas, pero sin una suscripción/licencia Insight válida LibreQoS admite solo los primeros 1000 circuitos mapeados válidos al estado de shaping activo.
+
+El límite predeterminado de 1000 circuitos mapeados aplica cuando Insight está:
+- ausente
+- expirado
+- inválido por cualquier motivo
+- operando con estado local de grant offline inválido
+
+Síntomas típicos visibles para el operador:
+- advertencia prominente de límite de circuitos mapeados en WebUI
+- indicador de uso en la navegación izquierda mostrando cercanía o agotamiento del límite de 1000
+- mensajes en `journalctl -u lqosd` con conteos requested/allowed/dropped
+- shaping parcial, con circuitos fuera del límite activo quedando fuera del estado de shaping
+
 Checks recomendados:
 
 1. Confirmar estado de licencia Insight en UI.

docs-es/v2.0/update-es.md

@@ -6,15 +6,47 @@ Si usas el puente XDP, el tráfico dejará de pasar por el puente mientras lqosd
 
 ## Si instalaste el .deb
 
+```{important}
+Desde v2.0, la ingesta de circuitos mapeados depende del estado válido de la licencia Insight. Sin una suscripción/licencia Insight válida, LibreQoS solo lee los primeros 1000 circuitos mapeados válidos al estado de shaping activo. Esto incluye estado local de grant/licencia expirado o inválido por cualquier motivo. Vea [Comportamiento de licenciamiento de Insight](insight-es.md#límites-de-circuitos-mapeados-y-estado-de-licencia) y [Solución de problemas](troubleshooting-es.md).
 ```
+
+Ejecuta:
+
+```bash
 cd ~
 sudo apt-get update
 sudo apt-get upgrade
 wget https://download.libreqos.com/{deb_url_v1_5}
 sudo apt install ./{deb_url_v1_5}
+```
+
+Si `apt install` termina normalmente, reinicia los servicios:
+
+```bash
 sudo systemctl restart lqosd lqos_scheduler
 ```
 
+### Hotfix de Ubuntu 24.04 si la actualización se detiene
+
+En hosts Ubuntu 24.04 afectados que usan `systemd-networkd`, `apt install` puede detenerse y mostrar un mensaje requiriendo el hotfix. Esto es esperado.
+
+Si eso ocurre, ejecuta:
+
+```bash
+sudo /opt/libreqos/src/systemd_hotfix.sh install
+sudo reboot
+```
+
+Después del reinicio, reanuda la actualización y reinicia los servicios:
+
+```bash
+cd ~
+sudo apt install ./{deb_url_v1_5}
+sudo systemctl restart lqosd lqos_scheduler
+```
+
+### Reinicio posterior a la actualización
+
 Ahora reinicia tu servidor LibreQoS con:
 
 ```
@@ -47,6 +79,22 @@ Si algo falla, vaya a [Solución de problemas](troubleshooting-es.md) antes de o
 4. Recompila: `./build-rust.sh`
 5. `sudo rust/remove_pinned_maps.sh`
 
+### Hotfix de Ubuntu 24.04 para instalaciones desde Git
+
+Antes de reiniciar los servicios de LibreQoS en Ubuntu 24.04, verifica si se debe ofrecer el hotfix de Noble para `systemd-networkd`:
+
+```bash
+cd /opt/libreqos/src
+./systemd_hotfix.sh status
+```
+
+Si el script indica que el hotfix debe ofrecerse, instálalo y reinicia antes de continuar:
+
+```bash
+sudo ./systemd_hotfix.sh install
+sudo reboot
+```
+
 Ejecuta los siguientes comandos para recargar los servicios de LibreQoS:
 
 ```shell

docs/v2.0/api.md

@@ -5,8 +5,9 @@
 The `lqos_api` (Node API service) requires an active LibreQoS Insight subscription.
 
 This is separate from base shaping limits:
-- Core LibreQoS shaping can run up to 1000 subscribers without Insight.
-- Higher subscriber limits depend on active Insight licensing.
+- `ShapedDevices.csv` can contain unlimited entries.
+- Without a valid Insight subscription/license, LibreQoS admits only the first 1000 valid mapped circuits into active shaping state.
+- Higher mapped-circuit counts depend on active Insight licensing.
 
 ## Source of Truth and Testing
 

docs/v2.0/insight.md

@@ -119,13 +119,26 @@ Operational notes:
 
 ### Mapped circuit limits and license state
 
-Recent builds enforce mapped-circuit limits based on license state.
+`ShapedDevices.csv` can contain unlimited entries. In current v2.0 builds, admission into active shaping state depends on valid Insight license state.
 
-If your node is unlicensed/invalid, LibreQoS can enforce a default mapped-circuit cap. When the cap is exceeded, logs include messages such as:
-- `Mapped circuit limit reached`
-- `Bakery mapped circuit cap enforced`
+Without a valid Insight subscription/license, LibreQoS admits only the first 1000 valid mapped circuits into active shaping state. Additional valid mapped circuits remain outside active shaping until valid Insight licensing is restored.
+
+A valid Insight subscription/license enables mapped-circuit counts above the default 1000 limit.
+
+The default 1000-limit behavior applies when Insight is:
+- missing
+- expired
+- otherwise invalid
+- operating with offline-invalid local grant state
+
+When the limit is reached, operators will typically see:
+- a prominent warning in WebUI
+- a left-nav usage indicator showing proximity to the limit
+- `lqosd` log messages such as:
+  - `Mapped circuit limit reached`
+  - `Bakery mapped circuit cap enforced`
 
 When this occurs, check:
 1. Insight license status in the UI.
 2. `journalctl -u lqosd` for requested/allowed/dropped mapped counts.
-3. Whether the number of mapped circuits exceeds your licensed allowance.
+3. Whether your node is operating at the default 1000 mapped-circuit limit because the current Insight/license state is invalid.

docs/v2.0/quickstart.md

@@ -29,9 +29,31 @@ wget https://download.libreqos.com/{deb_url_v1_5}
 sudo apt install ./{deb_url_v1_5}
 ```
 
+```{note}
+`ShapedDevices.csv` can contain unlimited entries. In v2.0, active shaping without a valid Insight subscription/license is limited to the first 1000 valid mapped circuits. See [Insight Licensing Behavior](insight.md#mapped-circuit-limits-and-license-state).
+```
+
+### Ubuntu 24.04 hotfix if the `.deb` install stops
+
+On affected Ubuntu 24.04 hosts using `systemd-networkd`, the `.deb` install may stop and print a hotfix requirement message. This is expected.
+
+If that happens, run:
+
+```bash
+sudo /opt/libreqos/src/systemd_hotfix.sh install
+sudo reboot
+```
+
+After the reboot, resume the install:
+
+```bash
+cd ~
+sudo apt install ./{deb_url_v1_5}
+```
+
 5. Open WebUI at `http://your_shaper_ip:9123`.
 
-## 2) 10-Minute Health Gate (Required Before Pilot)
+## 2) 10-Minute Health Check
 
 Run:
 

docs/v2.0/troubleshooting.md

@@ -207,7 +207,19 @@ If logs mention messages like:
 - `Mapped circuit limit reached`
 - `Bakery mapped circuit cap enforced`
 
-LibreQoS is enforcing a mapped-circuit cap. In current builds, default behavior without active Insight licensing enforces a finite mapped-circuit limit.
+`ShapedDevices.csv` can contain unlimited entries, but without a valid Insight subscription/license LibreQoS admits only the first 1000 valid mapped circuits into active shaping state.
+
+The default 1000 mapped-circuit limit applies when Insight is:
+- missing
+- expired
+- otherwise invalid
+- operating with offline-invalid local grant state
+
+Typical operator-visible symptoms:
+- prominent mapped-circuit-limit warning in WebUI
+- left-hand navigation usage indicator showing approach to or exhaustion of the 1000 limit
+- `journalctl -u lqosd` messages showing requested/allowed/dropped mapped counts
+- partial shaping, with circuits beyond the active limit left outside shaping state
 
 Recommended checks:
 1. Confirm Insight/license status in the UI.

docs/v2.0/update.md

@@ -6,21 +6,57 @@ If you use the XDP bridge, traffic will briefly stop passing through the bridge
 
 ## If you installed the .deb
 
+```{important}
+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 includes expired or otherwise invalid local grant/license state. See [Insight Licensing Behavior](insight.md#mapped-circuit-limits-and-license-state) and [Troubleshooting](troubleshooting.md).
 ```
+
+Run:
+
+```bash
 cd ~
 sudo apt-get update
 sudo apt-get upgrade
 wget https://download.libreqos.com/{deb_url_v1_5}
 sudo apt install ./{deb_url_v1_5}
+```
+
+If `apt install` completes normally, restart services:
+
+```bash
 sudo systemctl restart lqosd lqos_scheduler
 ```
 
-Now reboot the LibreQoS box with:
-```
+### Ubuntu 24.04 hotfix if the upgrade stops
+
+On affected Ubuntu 24.04 hosts using `systemd-networkd`, `apt install` may stop with a hotfix requirement message. This is expected.
+
+If that happens, run:
+
+```bash
+sudo /opt/libreqos/src/systemd_hotfix.sh install
 sudo reboot
 ```
+
+After the reboot, resume the upgrade and restart services:
+
+```bash
+cd ~
+sudo apt install ./{deb_url_v1_5}
+sudo systemctl restart lqosd lqos_scheduler
+```
+
+### Post-upgrade reboot
+
+Now reboot the LibreQoS box with:
+
+```bash
+sudo reboot
+```
+
 This will flush the old eBPF maps and load the latest LibreQoS version.
 
+Then continue with the normal post-upgrade validation below.
+
 ### Post-Upgrade Validation (Required)
 
 Run these checks after upgrade/reboot:
@@ -45,6 +81,22 @@ If checks fail, go directly to [Troubleshooting](troubleshooting.md) before furt
 5. Recompile: `./build_rust.sh`
 6. `sudo rust/remove_pinned_maps.sh`
 
+### Ubuntu 24.04 hotfix for Git installs
+
+Before restarting LibreQoS services on Ubuntu 24.04, check whether the Noble `systemd-networkd` hotfix should be offered:
+
+```bash
+cd /opt/libreqos/src
+./systemd_hotfix.sh status
+```
+
+If the script reports that the hotfix should be offered, install it and reboot before continuing:
+
+```bash
+sudo ./systemd_hotfix.sh install
+sudo reboot
+```
+
 Run the following commands to reload the LibreQoS services.
 
 ```shell