diff --git a/README.md b/README.md
index d6e470a..8531128 100644
--- a/README.md
+++ b/README.md
@@ -51,16 +51,54 @@ npm run db:migrate
 
 ## Déploiement Docker
 
-```bash
-# Avec SQLite (simple, fichier local persisté dans un volume)
-docker compose --profile sqlite -f docker/docker-compose.yml up -d
+> Détails complets dans [`docker/README.md`](./docker/README.md).
 
-# Avec PostgreSQL
-docker compose --profile postgres -f docker/docker-compose.yml up -d
+### Pré-requis
+
+- Docker Engine ≥ 24 + Docker Compose v2.24+ (`!reset` requis pour l'override bridge)
+- Linux natif **recommandé en production** (seul environnement où la découverte LAN fonctionne pleinement)
+
+### Configuration
+
+```bash
+cp .env.docker.example .env
+# Édite .env pour ajuster DISCOVERY_DEFAULT_CIDRS à ton LAN (ex: 192.168.1.0/24)
 ```
 
-> Le conteneur utilise `network_mode: host` pour permettre les scans ARP / mDNS /
-> ping sur le LAN. À désactiver si non nécessaire.
+### Linux natif (production homelab — recommandé)
+
+Mode `host` activé : la découverte ARP / mDNS / ping sweep voit l'ensemble du LAN.
+
+```bash
+# SQLite (autonome)
+docker compose -f docker/docker-compose.yml --profile sqlite up -d --build
+
+# OU PostgreSQL
+docker compose -f docker/docker-compose.yml --profile postgres up -d --build
+```
+
+UI : `http://<ip-de-la-machine>:3000`
+
+### macOS / Windows / Docker Desktop (dev local uniquement)
+
+`network_mode: host` ne fonctionne pas dans la VM Docker Desktop : on ajoute l'override bridge qui mappe explicitement `3000:3000`. ⚠️ La découverte LAN (ARP / mDNS / ping) sera **désactivée** — seule la saisie manuelle reste fonctionnelle.
+
+```bash
+docker compose \
+  -f docker/docker-compose.yml \
+  -f docker/docker-compose.bridge.yml \
+  --profile sqlite up -d --build
+```
+
+UI : <http://localhost:3000>
+
+### Commandes utiles
+
+```bash
+docker compose -f docker/docker-compose.yml logs -f ipam   # logs
+docker compose -f docker/docker-compose.yml down           # stop
+docker compose -f docker/docker-compose.yml down -v        # stop + suppression données
+```
 
 ## Découverte réseau
 
diff --git a/docker/README.md b/docker/README.md
index b38b7ae..19db5b6 100644
--- a/docker/README.md
+++ b/docker/README.md
@@ -5,8 +5,8 @@ Tout ce qu'il faut pour lancer l'application en une commande.
 ## Pré-requis
 
 - Docker Engine ≥ 24
-- Docker Compose v2 (`docker compose` et non `docker-compose`)
-- Linux conseillé (le mode `network_mode: host` n'est pas pleinement supporté sur Docker Desktop macOS/Windows ; voir la section *Bridge mode* plus bas)
+- Docker Compose **v2.24+** (le tag `!reset` utilisé par l'override bridge est requis)
+- Linux natif **fortement conseillé** : `network_mode: host` ne fonctionne pas dans la VM de Docker Desktop (macOS / Windows). Sur ces plateformes, utilise l'override bridge — voir plus bas — mais la découverte LAN (ARP / mDNS / ping sweep) sera désactivée.
 
 ## Fichiers fournis