Files
LibreQoS/docs/v2.0/integrations-netzur.md
T
2026-02-26 08:50:11 -07:00

1.4 KiB

Netzur Integration

Netzur deployments expose subscriber and zone inventories via a REST endpoint secured with a Bearer token. Configure /etc/lqos.conf as follows:

[netzur_integration]
enable_netzur = true
api_key = "your-netzur-token"
api_url = "https://netzur.example.com/api/libreqos"
timeout_secs = 60
use_mikrotik_ipv6 = false
  • enable_netzur toggles automatic imports by lqos_scheduler.
  • api_key is the Bearer token generated inside Netzur.
  • api_url must return JSON containing zones (mapped to sites) and customers (mapped to client circuits and devices).
  • timeout_secs overrides the default HTTP timeout (60 seconds) when the API is slow.
  • use_mikrotik_ipv6 enriches subscriber devices with IPv6 prefixes discovered via mikrotikDHCPRouterList.csv.

Run a manual import with:

python3 integrationNetzur.py

The integration regenerates ShapedDevices.csv and, unless always_overwrite_network_json is disabled, updates network.json. Adjust the Integration → Common settings if you need to preserve an existing network map between Netzur syncs.

Overwrite policy:

  • Recommended: keep always_overwrite_network_json = true for integration-driven deployments so topology stays aligned with Netzur syncs.