From 0bfe3ab87a9ec8f5059c689b2a174aca233d8345 Mon Sep 17 00:00:00 2001
From: Sylvester Kaczmarek
 <16242628+sylvesterkaczmarek@users.noreply.github.com>
Date: Tue, 18 Aug 2026 08:29:44 +0100
Subject: [PATCH] docs: note render-plan DNS resolution

---
 docs/cli.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/cli.md b/docs/cli.md
index a20b27b..3221bf4 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -31,7 +31,7 @@ This shows the operating system, architecture, available backend, and reference
 fence render-plan --config policy.json
 ```
 
-This validates a JSON configuration and prints the firewall rules without applying them.
+This validates a JSON configuration and prints the firewall rules without applying them. Exact hostname allowlist entries are resolved through the system resolver while the plan is built, so a preview that contains hostnames can perform DNS lookups and can fail if resolution is unavailable.
 
 ## Run The Agent