diff --git a/DIAGNOSTIC-OpenRemote.md b/DIAGNOSTIC-OpenRemote.md
new file mode 100644
index 00000000..de5ddf98
--- /dev/null
+++ b/DIAGNOSTIC-OpenRemote.md
@@ -0,0 +1,21 @@
+# Diagnostic OpenRemote - Session 2026-05-05
+
+## Erreur observée
+```
+⚠️  OpenRemote token → <urlopen error [Errno -2] Name or service not known>
+```
+
+## Cause racine
+Le simulateur (`simulator.py`) utilise:
+- `OR_URL = http://localhost:8080` (Traefik → OpenRemote Manager)
+- Token URL: `http://openremote-keycloak-1:8080/auth/realms/{realm}/protocol/openid-connect/token`
+
+**Problème** : `openremote-keycloak-1` est un hostname **interne Docker**. Depuis l'hôte (où tourne le simulateur), ce hostname n'est pas résoluble.
+
+## Solution
+1. Modifier `simulator.py` pour utiliser `localhost:8080` partout (Traefik gère le routage)
+2. Ou ajouter `openremote-keycloak-1` dans `/etc/hosts` de l'hôte
+3. Ou lancer le simulateur dans le même réseau Docker qu'OpenRemote
+
+## Status
+❌ **BLOQUÉ** (à réparer plus tard)