diff --git a/README.md b/README.md
index 2bff02a..529d933 100644
--- a/README.md
+++ b/README.md
@@ -107,7 +107,20 @@ aussen — kein anderer Rechner kommt mehr direkt ran.
    verstuemmelter Hash an und das Dashboard bleibt bei "no auth providers
    are registered" haengen, obwohl alles "richtig" eingetragen aussieht.
    **Jedes `$` im Hash durch `$$` ersetzen**, bevor Du ihn in `.env`
-   eintraegst (z.B. `260000$abc$def` → `260000$$abc$$def`).
+   eintraegst (z.B. `260000$abc$def` → `260000$$abc$$def`). Anfuehrungszeichen
+   um den Wert helfen dabei NICHT — Compose expandiert `$` in `.env`-Werten
+   unabhaengig davon ob sie gequotet sind.
+
+   Am einfachsten den Hash direkt per `sed` in der Zeile escapen, statt ihn
+   von Hand nochmal abzutippen (verdoppelt NUR die `$` in genau dieser einen
+   Zeile):
+   ```bash
+   sed -i '/^HERMES_DASHBOARD_PASSWORD_HASH=/ s/\$/$$/g' .env
+   ```
+   Zur Kontrolle, ob noch unverdoppelte `$` uebrig sind (sollte leer sein):
+   ```bash
+   grep -o '\$[^$]' .env
+   ```
 
    Output (den escapeten Hash, nicht das Passwort) in `.env` bei
    `HERMES_DASHBOARD_PASSWORD_HASH` eintragen, `HERMES_DASHBOARD_USER`
@@ -117,6 +130,29 @@ aussen — kein anderer Rechner kommt mehr direkt ran.
    aus den Container-Env-Vars expandiert — kein manuelles Ausfuellen noetig,
    siehe Schritt 3).
 
+   **WICHTIG, wenn Du Schritt 3 schon VOR dem 19.07.2026 gemacht hast:**
+   Schritt 3 kopiert `config.yaml.example` nur EINMALIG nach
+   `hermes-data/agent-home/config.yaml` — kein automatischer Re-Sync danach.
+   Der `dashboard:`-Block wurde erst nachtraeglich in die `.example`-Datei
+   ergaenzt, landet also NICHT von selbst in einer bereits existierenden
+   `config.yaml`. Ohne ihn bleibt Hermes bei "no auth providers are
+   registered" haengen, egal wie sauber `.env` escaped ist (weil Hermes den
+   Block ja gar nicht sieht). Pruefen:
+   ```bash
+   grep -A3 '^dashboard:' hermes-data/agent-home/config.yaml
+   ```
+   Kommt nichts zurueck → Block manuell anhaengen:
+   ```bash
+   cat >> hermes-data/agent-home/config.yaml <<'EOF'
+
+   dashboard:
+     basic_auth:
+       username: "${HERMES_DASHBOARD_USER}"
+       password_hash: "${HERMES_DASHBOARD_PASSWORD_HASH}"
+   EOF
+   ```
+   Danach neu hochziehen: `docker compose up -d --build hermes-agent-dashboard`
+
 5. **Stack starten:**
    ```bash
    docker compose up -d