From 9a5d23dd41a1e0886907c2e24a8f3e81db067276 Mon Sep 17 00:00:00 2001 From: Davide Principi Date: Fri, 16 Oct 2026 12:38:00 +0200 Subject: [PATCH 1/3] docs: document Traefik Labs telemetry endpoint The Traefik instance of every node checks update.traefik.io once a day for new releases. List it in a separate table of the system requirements page, so administrators know the traffic is expected, and explain that the internal Traefik copies of other applications have the check disabled. Assisted-by: Claude Code:claude-opus-5.5 --- .../installation/system_requirements.md | 10 ++++++++++ .../installation/system_requirements.md | 10 ++++++++++ 2 files changed, 20 insertions(+) diff --git a/docs/administrator-manual/installation/system_requirements.md b/docs/administrator-manual/installation/system_requirements.md index 98aefc1f5..05bdcc632 100644 --- a/docs/administrator-manual/installation/system_requirements.md +++ b/docs/administrator-manual/installation/system_requirements.md @@ -151,6 +151,16 @@ NS8 core components include Loki, used for [logs persistence](../configuration/l If a DNS filter, such as Pi-hole, blocks `stats.grafana.org`, the failed requests can generate a high number of DNS queries. To disable the telemetry, follow the instructions of the [Loki](https://github.com/NethServer/ns8-loki#disable-telemetry) and [Metrics](https://github.com/NethServer/ns8-metrics#disable-telemetry) modules. +Each NS8 node runs Traefik, the proxy that handles [HTTP routes](../configuration/proxy.md). It is developed by Traefik Labs and checks once a day for new Traefik releases. NS8 deliberately leaves this check enabled: when a new release exists, Traefik writes a warning in its log. Some applications, such as Loki and NethSecurity controller, run their own internal copy of Traefik: in those copies the check is disabled. The anonymous usage statistics of Traefik are always disabled. + +| Purpose | Host name | Port | Protocol | Notes | +|----|----|----|----|----| +| Traefik new version check | update.traefik.io | 443 | HTTPS | Sent once a day by the Traefik instance of every node | + +

Telemetry endpoints of Traefik Labs components

+ +If `update.traefik.io` is not reachable, Traefik only writes a warning in its log once a day. + Notes - All listed connections are initiated by the NS8 node. diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/system_requirements.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/system_requirements.md index 6ba3043e2..65a44132b 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/system_requirements.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/system_requirements.md @@ -144,6 +144,16 @@ I componenti del core di NS8 includono Loki, usato per la [persistenza dei log]( Se un filtro DNS, come Pi-hole, blocca `stats.grafana.org`, le richieste fallite possono generare un numero elevato di query DNS. Per disattivare la telemetria, segui le istruzioni dei moduli [Loki](https://github.com/NethServer/ns8-loki#disable-telemetry) e [Metrics](https://github.com/NethServer/ns8-metrics#disable-telemetry). +Ogni nodo NS8 esegue Traefik, il proxy che gestisce le [route HTTP](../configuration/proxy.md). È sviluppato da Traefik Labs e controlla una volta al giorno se esistono nuove versioni di Traefik. NS8 lascia deliberatamente attivo questo controllo: quando esiste una nuova versione, Traefik scrive un avviso nel suo log. Alcune applicazioni, come Loki e NethSecurity controller, eseguono una propria copia interna di Traefik: in queste copie il controllo è disattivato. Le statistiche di utilizzo anonime di Traefik sono sempre disattivate. + +| Scopo | Nome host | Porta | Protocollo | Note | +|----|----|----|----|----| +| Controllo nuove versioni di Traefik | update.traefik.io | 443 | HTTPS | Inviato una volta al giorno dall'istanza di Traefik di ogni nodo | + +

Endpoint di telemetria dei componenti di Traefik Labs

+ +Se `update.traefik.io` non è raggiungibile, Traefik scrive solo un avviso nel suo log una volta al giorno. + Note - Tutte le connessioni elencate sono avviate dal nodo NS8. From e4de47d750bd33fba29f63d0225041f83d95550e Mon Sep 17 00:00:00 2001 From: Davide Principi Date: Fri, 16 Oct 2026 12:49:48 +0200 Subject: [PATCH 2/3] docs: merge third-party telemetry tables Telemetry and update checks of third-party components are not required for NS8 to work, unlike the endpoints listed before them, whose notes warn that blocking them breaks updates and backups. Move the Grafana Labs and Traefik Labs endpoints into one table, in a section of its own, so the notes no longer seem to apply to them. Assisted-by: Claude Code:claude-opus-5.5 --- .../installation/system_requirements.md | 28 +++++++++---------- .../installation/system_requirements.md | 28 +++++++++---------- 2 files changed, 26 insertions(+), 30 deletions(-) diff --git a/docs/administrator-manual/installation/system_requirements.md b/docs/administrator-manual/installation/system_requirements.md index 05bdcc632..d8a9c3f5e 100644 --- a/docs/administrator-manual/installation/system_requirements.md +++ b/docs/administrator-manual/installation/system_requirements.md @@ -140,32 +140,30 @@ A NethServer 8 (NS8) node requires outbound network connectivity to a number of

Endpoints used by cluster leader node with an active Subscription

-NS8 core components include Loki, used for [logs persistence](../configuration/log_server.md#logs-persistence-section), and Grafana, used for [Grafana dashboards](../configuration/metrics.md#grafana_access-section). Both are developed by Grafana Labs and send anonymous usage statistics. NS8 deliberately leaves this telemetry enabled. The update checks of Grafana and the telemetry of the log collector are disabled. +Notes -| Purpose | Host name | Port | Protocol | Notes | -|----|----|----|----|----| -| Loki usage statistics | stats.grafana.org | 443 | HTTPS | Sent by every Loki instance | -| Grafana usage statistics | stats.grafana.org | 443 | HTTPS | Sent only if Grafana dashboards are enabled | +- All listed connections are initiated by the NS8 node. +- Blocking access to these services can prevent updates, application installation, backups, cluster formation, or subscription validation. +- Additional outbound connections may be required by specific features, such as email notifications and HTTP routes, and by installed applications, depending on their configuration and upstream services. -

Telemetry endpoints of Grafana Labs components

+## Third-party telemetry endpoints {#third-party-telemetry} -If a DNS filter, such as Pi-hole, blocks `stats.grafana.org`, the failed requests can generate a high number of DNS queries. To disable the telemetry, follow the instructions of the [Loki](https://github.com/NethServer/ns8-loki#disable-telemetry) and [Metrics](https://github.com/NethServer/ns8-metrics#disable-telemetry) modules. +Some NS8 components are developed by third parties and contact their vendor's servers, to send anonymous usage statistics or to check for new releases. These connections are not required for NS8 to work. NS8 deliberately leaves some of them enabled, as set by the upstream defaults, and disables the others: -Each NS8 node runs Traefik, the proxy that handles [HTTP routes](../configuration/proxy.md). It is developed by Traefik Labs and checks once a day for new Traefik releases. NS8 deliberately leaves this check enabled: when a new release exists, Traefik writes a warning in its log. Some applications, such as Loki and NethSecurity controller, run their own internal copy of Traefik: in those copies the check is disabled. The anonymous usage statistics of Traefik are always disabled. +- Loki, used for [logs persistence](../configuration/log_server.md#logs-persistence-section), and Grafana, used for [Grafana dashboards](../configuration/metrics.md#grafana_access-section), are developed by Grafana Labs and send anonymous usage statistics. The update checks of Grafana and the telemetry of the log collector are disabled. +- Traefik, the proxy that handles [HTTP routes](../configuration/proxy.md), is developed by Traefik Labs and checks once a day for new releases: when a new release exists, Traefik writes a warning in its log. Its anonymous usage statistics are disabled. Some applications, such as Loki and NethSecurity controller, run their own internal copy of Traefik: in those copies the check is disabled. | Purpose | Host name | Port | Protocol | Notes | |----|----|----|----|----| +| Loki usage statistics | stats.grafana.org | 443 | HTTPS | Sent by every Loki instance | +| Grafana usage statistics | stats.grafana.org | 443 | HTTPS | Sent only if Grafana dashboards are enabled | | Traefik new version check | update.traefik.io | 443 | HTTPS | Sent once a day by the Traefik instance of every node | -

Telemetry endpoints of Traefik Labs components

- -If `update.traefik.io` is not reachable, Traefik only writes a warning in its log once a day. +

Third-party telemetry endpoints of NS8 components

-Notes +If a DNS filter, such as Pi-hole, blocks `stats.grafana.org`, the failed requests can generate a high number of DNS queries. To disable the telemetry, follow the instructions of the [Loki](https://github.com/NethServer/ns8-loki#disable-telemetry) and [Metrics](https://github.com/NethServer/ns8-metrics#disable-telemetry) modules. -- All listed connections are initiated by the NS8 node. -- Blocking access to these services can prevent updates, application installation, backups, cluster formation, or subscription validation. -- Additional outbound connections may be required by specific features, such as email notifications and HTTP routes, and by installed applications, depending on their configuration and upstream services. +If `update.traefik.io` is not reachable, Traefik only writes a warning in its log once a day. ## Web browser requirements diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/system_requirements.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/system_requirements.md index 65a44132b..789212df5 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/system_requirements.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/system_requirements.md @@ -133,32 +133,30 @@ Un nodo NethServer 8 (NS8) richiede connettività di rete in uscita verso una se

Endpoint utilizzati dal nodo leader del cluster con una subscription attiva

-I componenti del core di NS8 includono Loki, usato per la [persistenza dei log](../configuration/log_server.md#logs-persistence-section), e Grafana, usato per le [dashboard Grafana](../configuration/metrics.md#grafana_access-section). Entrambi sono sviluppati da Grafana Labs e inviano statistiche di utilizzo anonime. NS8 lascia deliberatamente attiva questa telemetria. I controlli degli aggiornamenti di Grafana e la telemetria del raccoglitore dei log sono disattivati. +Note -| Scopo | Nome host | Porta | Protocollo | Note | -|----|----|----|----|----| -| Statistiche di utilizzo di Loki | stats.grafana.org | 443 | HTTPS | Inviate da ogni istanza di Loki | -| Statistiche di utilizzo di Grafana | stats.grafana.org | 443 | HTTPS | Inviate solo se le dashboard Grafana sono attive | +- Tutte le connessioni elencate sono avviate dal nodo NS8. +- Bloccare l'accesso a questi servizi può impedire aggiornamenti, installazione di applicazioni, backup, formazione del cluster o validazione delle subscription. +- Potrebbero essere necessarie connessioni in uscita aggiuntive per funzionalità specifiche, come le notifiche email e i percorsi HTTP, e per le applicazioni installate, a seconda della loro configurazione e dei servizi upstream. -

Endpoint di telemetria dei componenti di Grafana Labs

+## Endpoint di telemetria di terze parti {#third-party-telemetry} -Se un filtro DNS, come Pi-hole, blocca `stats.grafana.org`, le richieste fallite possono generare un numero elevato di query DNS. Per disattivare la telemetria, segui le istruzioni dei moduli [Loki](https://github.com/NethServer/ns8-loki#disable-telemetry) e [Metrics](https://github.com/NethServer/ns8-metrics#disable-telemetry). +Alcuni componenti di NS8 sono sviluppati da terze parti e contattano i server del loro produttore, per inviare statistiche di utilizzo anonime o per controllare se esistono nuove versioni. Queste connessioni non sono necessarie al funzionamento di NS8. NS8 ne lascia deliberatamente attive alcune, come previsto dalle impostazioni predefinite dei produttori, e disattiva le altre: -Ogni nodo NS8 esegue Traefik, il proxy che gestisce le [route HTTP](../configuration/proxy.md). È sviluppato da Traefik Labs e controlla una volta al giorno se esistono nuove versioni di Traefik. NS8 lascia deliberatamente attivo questo controllo: quando esiste una nuova versione, Traefik scrive un avviso nel suo log. Alcune applicazioni, come Loki e NethSecurity controller, eseguono una propria copia interna di Traefik: in queste copie il controllo è disattivato. Le statistiche di utilizzo anonime di Traefik sono sempre disattivate. +- Loki, usato per la [persistenza dei log](../configuration/log_server.md#logs-persistence-section), e Grafana, usato per le [dashboard Grafana](../configuration/metrics.md#grafana_access-section), sono sviluppati da Grafana Labs e inviano statistiche di utilizzo anonime. I controlli degli aggiornamenti di Grafana e la telemetria del raccoglitore dei log sono disattivati. +- Traefik, il proxy che gestisce le [route HTTP](../configuration/proxy.md), è sviluppato da Traefik Labs e controlla una volta al giorno se esistono nuove versioni: quando esiste una nuova versione, Traefik scrive un avviso nel suo log. Le sue statistiche di utilizzo anonime sono disattivate. Alcune applicazioni, come Loki e NethSecurity controller, eseguono una propria copia interna di Traefik: in queste copie il controllo è disattivato. | Scopo | Nome host | Porta | Protocollo | Note | |----|----|----|----|----| +| Statistiche di utilizzo di Loki | stats.grafana.org | 443 | HTTPS | Inviate da ogni istanza di Loki | +| Statistiche di utilizzo di Grafana | stats.grafana.org | 443 | HTTPS | Inviate solo se le dashboard Grafana sono attive | | Controllo nuove versioni di Traefik | update.traefik.io | 443 | HTTPS | Inviato una volta al giorno dall'istanza di Traefik di ogni nodo | -

Endpoint di telemetria dei componenti di Traefik Labs

- -Se `update.traefik.io` non è raggiungibile, Traefik scrive solo un avviso nel suo log una volta al giorno. +

Endpoint di telemetria di terze parti dei componenti di NS8

-Note +Se un filtro DNS, come Pi-hole, blocca `stats.grafana.org`, le richieste fallite possono generare un numero elevato di query DNS. Per disattivare la telemetria, segui le istruzioni dei moduli [Loki](https://github.com/NethServer/ns8-loki#disable-telemetry) e [Metrics](https://github.com/NethServer/ns8-metrics#disable-telemetry). -- Tutte le connessioni elencate sono avviate dal nodo NS8. -- Bloccare l'accesso a questi servizi può impedire aggiornamenti, installazione di applicazioni, backup, formazione del cluster o validazione delle subscription. -- Potrebbero essere necessarie connessioni in uscita aggiuntive per funzionalità specifiche, come le notifiche email e i percorsi HTTP, e per le applicazioni installate, a seconda della loro configurazione e dei servizi upstream. +Se `update.traefik.io` non è raggiungibile, Traefik scrive solo un avviso nel suo log una volta al giorno. ## Requisiti del browser web From 0babf9bd0548ca261994bc96dc010b27f5b3d25a Mon Sep 17 00:00:00 2001 From: Davide Principi Date: Fri, 16 Oct 2026 12:56:46 +0200 Subject: [PATCH 3/3] docs: link Traefik version check opt-out Point administrators to the Traefik module instructions to disable the daily new version check, as done for Loki and Grafana. Assisted-by: Claude Code:claude-opus-5.5 --- docs/administrator-manual/installation/system_requirements.md | 2 +- .../administrator-manual/installation/system_requirements.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/administrator-manual/installation/system_requirements.md b/docs/administrator-manual/installation/system_requirements.md index d8a9c3f5e..0a1b18048 100644 --- a/docs/administrator-manual/installation/system_requirements.md +++ b/docs/administrator-manual/installation/system_requirements.md @@ -163,7 +163,7 @@ Some NS8 components are developed by third parties and contact their vendor's se If a DNS filter, such as Pi-hole, blocks `stats.grafana.org`, the failed requests can generate a high number of DNS queries. To disable the telemetry, follow the instructions of the [Loki](https://github.com/NethServer/ns8-loki#disable-telemetry) and [Metrics](https://github.com/NethServer/ns8-metrics#disable-telemetry) modules. -If `update.traefik.io` is not reachable, Traefik only writes a warning in its log once a day. +If `update.traefik.io` is not reachable, Traefik only writes a warning in its log once a day. To disable the check, follow the instructions of the [Traefik](https://github.com/NethServer/ns8-traefik#disable-telemetry) module. ## Web browser requirements diff --git a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/system_requirements.md b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/system_requirements.md index 789212df5..75099f1c5 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/system_requirements.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/administrator-manual/installation/system_requirements.md @@ -156,7 +156,7 @@ Alcuni componenti di NS8 sono sviluppati da terze parti e contattano i server de Se un filtro DNS, come Pi-hole, blocca `stats.grafana.org`, le richieste fallite possono generare un numero elevato di query DNS. Per disattivare la telemetria, segui le istruzioni dei moduli [Loki](https://github.com/NethServer/ns8-loki#disable-telemetry) e [Metrics](https://github.com/NethServer/ns8-metrics#disable-telemetry). -Se `update.traefik.io` non è raggiungibile, Traefik scrive solo un avviso nel suo log una volta al giorno. +Se `update.traefik.io` non è raggiungibile, Traefik scrive solo un avviso nel suo log una volta al giorno. Per disattivare il controllo, segui le istruzioni del modulo [Traefik](https://github.com/NethServer/ns8-traefik#disable-telemetry). ## Requisiti del browser web