From 6fa64c431ee349bd99fb44ba6a1b1ac19c67b292 Mon Sep 17 00:00:00 2001
From: rchac <robert@libreqos.io>
Date: Tue, 5 May 2026 22:25:33 +0000
Subject: [PATCH] changes

---
 docs-es/v2.0/integrations-reference-es.md | 28 +++++++++++++++++++++++
 docs/v2.0/integrations-netzur.md          | 26 +++++++++++++++++++++
 docs/v2.0/integrations-reference.md       | 28 +++++++++++++++++++++++
 src/mikrotik_ipv6.example.toml            |  9 ++++++++
 4 files changed, 91 insertions(+)

diff --git a/docs-es/v2.0/integrations-reference-es.md b/docs-es/v2.0/integrations-reference-es.md
index aa8651fc..1b7cf070 100644
--- a/docs-es/v2.0/integrations-reference-es.md
+++ b/docs-es/v2.0/integrations-reference-es.md
@@ -153,6 +153,34 @@ use_mikrotik_ipv6 = false
 - `timeout_secs` permite incrementar el tiempo de espera de la petición cuando el API responde lentamente (por defecto 60 segundos).
 - `use_mikrotik_ipv6` agrega prefijos IPv6 obtenidos de `/etc/libreqos/mikrotik_ipv6.toml`. LibreQoS relaciona IPv4 e IPv6 por dirección MAC usando datos de ARP, DHCPv4, DHCPv6 y vecinos IPv6 de MikroTik.
 
+### Credenciales de routers MikroTik para IPv6
+
+Cuando `use_mikrotik_ipv6` o `ipv6_with_mikrotik` esté habilitado, cree `/etc/libreqos/mikrotik_ipv6.toml`. Agregue un bloque `[[router]]` por cada router MikroTik que LibreQoS deba consultar:
+
+```toml
+version = 1
+
+[[router]]
+name = "core-1"
+host = "100.64.0.1"
+port = 8728
+username = "libreqos"
+password = "secreto"
+use_ssl = false
+plaintext_login = true
+
+[[router]]
+name = "core-2"
+host = "100.64.0.2"
+port = 8728
+username = "libreqos"
+password = "secreto"
+use_ssl = false
+plaintext_login = true
+```
+
+Agregue más bloques `[[router]]` para más routers. `port`, `use_ssl` y `plaintext_login` pueden omitirse cuando los valores por defecto son correctos: puerto `8728`, SSL deshabilitado y login en texto plano habilitado.
+
 Para una importación manual:
 
 ```bash
diff --git a/docs/v2.0/integrations-netzur.md b/docs/v2.0/integrations-netzur.md
index 3e18bd04..49bf7f3b 100644
--- a/docs/v2.0/integrations-netzur.md
+++ b/docs/v2.0/integrations-netzur.md
@@ -17,6 +17,32 @@ use_mikrotik_ipv6 = false
 - `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 `/etc/libreqos/mikrotik_ipv6.toml`. LibreQoS matches IPv4 and IPv6 by MAC address using MikroTik ARP, DHCPv4, DHCPv6, and IPv6 neighbor data.
 
+When `use_mikrotik_ipv6` is enabled, create `/etc/libreqos/mikrotik_ipv6.toml`. Add one `[[router]]` block for each MikroTik router LibreQoS should query:
+
+```toml
+version = 1
+
+[[router]]
+name = "core-1"
+host = "100.64.0.1"
+port = 8728
+username = "libreqos"
+password = "secret"
+use_ssl = false
+plaintext_login = true
+
+[[router]]
+name = "core-2"
+host = "100.64.0.2"
+port = 8728
+username = "libreqos"
+password = "secret"
+use_ssl = false
+plaintext_login = true
+```
+
+Use additional `[[router]]` blocks for additional routers. `port`, `use_ssl`, and `plaintext_login` can be omitted when the defaults are correct: port `8728`, SSL disabled, and plaintext login enabled.
+
 Run a manual import with:
 
 ```bash
diff --git a/docs/v2.0/integrations-reference.md b/docs/v2.0/integrations-reference.md
index 11c79949..0cffe36f 100644
--- a/docs/v2.0/integrations-reference.md
+++ b/docs/v2.0/integrations-reference.md
@@ -155,6 +155,34 @@ use_mikrotik_ipv6 = false
 - `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 `/etc/libreqos/mikrotik_ipv6.toml`. LibreQoS matches IPv4 and IPv6 by MAC address using MikroTik ARP, DHCPv4, DHCPv6, and IPv6 neighbor data.
 
+### MikroTik IPv6 Router Credentials
+
+When `use_mikrotik_ipv6` or `ipv6_with_mikrotik` is enabled, create `/etc/libreqos/mikrotik_ipv6.toml`. Add one `[[router]]` block for each MikroTik router LibreQoS should query:
+
+```toml
+version = 1
+
+[[router]]
+name = "core-1"
+host = "100.64.0.1"
+port = 8728
+username = "libreqos"
+password = "secret"
+use_ssl = false
+plaintext_login = true
+
+[[router]]
+name = "core-2"
+host = "100.64.0.2"
+port = 8728
+username = "libreqos"
+password = "secret"
+use_ssl = false
+plaintext_login = true
+```
+
+Use additional `[[router]]` blocks for additional routers. `port`, `use_ssl`, and `plaintext_login` can be omitted when the defaults are correct: port `8728`, SSL disabled, and plaintext login enabled.
+
 Run a manual import with:
 
 ```bash
diff --git a/src/mikrotik_ipv6.example.toml b/src/mikrotik_ipv6.example.toml
index 9f857a52..7b49cae1 100644
--- a/src/mikrotik_ipv6.example.toml
+++ b/src/mikrotik_ipv6.example.toml
@@ -8,3 +8,12 @@ username = "admin"
 password = "password"
 use_ssl = false
 plaintext_login = true
+
+[[router]]
+name = "secondary"
+host = "100.64.0.2"
+port = 8728
+username = "admin"
+password = "password"
+use_ssl = false
+plaintext_login = true