diff --git a/DEPLOYMENT.md b/DEPLOYMENT.md
index fa0e603..8492847 100644
--- a/DEPLOYMENT.md
+++ b/DEPLOYMENT.md
@@ -763,6 +763,14 @@ sudo -H -u voice .venv/bin/pip install -e ".[local]"
 sudo -H -u voice .venv/bin/pip install faster-whisper piper-tts
 ```
 
+> **Hinweis:** `.[local]` pinnt `av<19` — ab av 19 crasht faster-whisper 1.2.1 bei jeder
+> Transkription (`TypeError: open() got an unexpected keyword argument 'metadata_errors'`).
+> Die Tests decken das nicht ab; nach einem venv-Neuaufbau einmal echt transkribieren.
+>
+> **Nach einem Ubuntu-Release-Upgrade** (neue Python-Version, z. B. 24.04 → 26.04 mit
+> 3.12 → 3.14) ist die venv unbrauchbar (`No module named 'uvicorn'`) und muss neu gebaut
+> werden — inkl. `seven-send` (Abschnitt Notruf-Bridge). Beide Services vorher stoppen.
+
 ### 2.4 Piper-Stimmen herunterladen (10 Sprachen, 16 Dateien)
 
 | Dateiname | Sprache | Geschlecht | Qualität |
diff --git a/pyproject.toml b/pyproject.toml
index 4d152c6..10b4046 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -21,7 +21,10 @@ test = [
 # lokales TTS via piper (in-process -> Modell bleibt geladen, kein Start pro Satz).
 local = [
   "faster-whisper>=1.0",
-  "piper-tts>=1.2"
+  "piper-tts>=1.2",
+  # av>=19 kennt av.open(metadata_errors=...) nicht mehr -> faster-whisper 1.2.1
+  # crasht bei jeder Transkription (TypeError). Aufheben, sobald faster-whisper fixt.
+  "av<19"
 ]
 
 [build-system]