From 7ec5d44517bb4c7044538c931a9e769b21d6aa3e Mon Sep 17 00:00:00 2001
From: mm <mm@kalina>
Date: Mon, 14 Sep 2026 10:29:49 +0200
Subject: [PATCH] docs: Timeout-Tabelle + ACL-Phase dauert bis 3 Minuten

---
 README.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/README.md b/README.md
index ce85ae9..483ba93 100644
--- a/README.md
+++ b/README.md
@@ -45,6 +45,31 @@ oben die sichere Wahl.
 bis `Node=… Apache=1`, dann kamen `Scanning processes…`-Zeilen, danach
 Quelltext-Ausgaben, und `apache.conf` fehlte am Ende.
 
+## Wenn der Lauf hängt
+
+Der Installer darf **nie unbegrenzt warten**. Alle Netzwerkaufrufe haben
+Timeouts, und die ACL-Phase meldet sich vorher:
+
+```
+[netbird-telegraf] Log-Leserechte: pruefe/ergaenze ACL fuer 'telegraf' (kann etwas dauern) …
+```
+
+Diese Zeile dauert auf einem frischen System bis zu **3 Minuten** — dort läuft
+`apt-get update` + `apt-get install acl`. Erscheint sie und danach nichts,
+nicht sofort abbrechen: bis 3 Minuten ist normal.
+
+| Aufruf | Timeout | Versuche |
+|---|---|---|
+| `fetch` (Confs/Scripts vom Repo) | 30 s | 3 |
+| `apt-get update` / `install acl` | 180 s | 1 |
+| InfluxData-Keyring | 30 s | 1 |
+| Telegraf-Binary (statisch) | 120 s | 1 |
+| Selbstschutz-Download | 30 s | 1 |
+
+**Vor 1.5.0 gab es diese Timeouts nicht** — `fetch()` wartete unbegrenzt. Symptom:
+der Lauf bleibt nach der letzten Erfolgsmeldung stehen, ohne Fehler; man bricht
+mit `^C` ab und weiß nicht, wo es hing. Real passiert auf `x14`.
+
 ## Diagnose: „Logs kommen nicht an"
 
 Ein Befehl zeigt, warum: