From 0dd657d05f4438bef7044fae12776a17798d2fb9 Mon Sep 17 00:00:00 2001
From: Pulse Monitor <pulse@pulse-monitor.dev>
Date: Thu, 21 Aug 2025 15:49:56 +0000
Subject: [PATCH] docs: restore and improve Docker network discovery section
 with clearer explanation

---
 README.md | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 97533e86c..abbe98c67 100644
--- a/README.md
+++ b/README.md
@@ -104,9 +104,24 @@ docker run -d \
   -v pulse_data:/data \
   --restart unless-stopped \
   rcourtman/pulse:latest
+```
 
-# Discovery automatically finds Proxmox nodes on your network!
-# For custom subnets (optional): -e DISCOVERY_SUBNET="192.168.50.0/24"
+### Network Discovery
+
+Pulse automatically discovers Proxmox nodes on your network! By default, it scans:
+- 192.168.0.0/16 (home networks)
+- 10.0.0.0/8 (private networks)
+- 172.16.0.0/12 (Docker/internal networks)
+
+To scan a custom subnet instead:
+```bash
+docker run -d \
+  --name pulse \
+  -p 7655:7655 \
+  -v pulse_data:/data \
+  -e DISCOVERY_SUBNET="192.168.50.0/24" \
+  --restart unless-stopped \
+  rcourtman/pulse:latest
 ```
 
 ### Automated Deployment