docs: warn about audit-log attributes with logtail disabled

Updates #3522

(cherry picked from commit cced8a0ab, docs only)
(cherry picked from commit 7d8cfe13f)
This commit is contained in:
Kristoffer Dalby committed 2026-10-13 14:35:52 +02:00
1 parent fb619274a9
commit 0f7d1e536b
1 file changed
+5
+5
View File
@@ -206,6 +206,11 @@ Headscale, by default, instructs clients to disable log submission to the centra
applied by a client once it successfully connected with Headscale. See the configuration option `logtail.enabled` in the
[configuration file](../ref/configuration.md) for details.
Do not grant the `https://tailscale.com/cap/data-plane-audit-logs` node attribute while `logtail.enabled` is `false`. A
client with log submission disabled treats this attribute as "the tailnet requires logging" and turns itself off, as
`tailscale down` would. It stays off until the attribute is removed and `tailscale up` is run. A client started with
`TS_NO_LOGS_NO_SUPPORT=true` or `--no-logs-no-support` reacts the same way, whatever `logtail.enabled` says.
Alternatively, logging can also be disabled on the client side. This is independent of Headscale and opting out of
client logging disables log submission early during client startup. The configuration is operating system specific and
is usually achieved by setting the environment variable `TS_NO_LOGS_NO_SUPPORT=true` or by passing the flag