From 74e0d5fcd601ff3894ba49751f0b0fb54bc5268d Mon Sep 17 00:00:00 2001
From: pyr0ball <pyroballpcs@gmail.com>
Date: Tue, 26 May 2026 13:39:38 -0700
Subject: [PATCH] =?UTF-8?q?docs(container):=20fix=20GPU=5FSERVER=5FURL=20f?=
 =?UTF-8?q?or=20Contributor2=20=E2=80=94=20use=20public=20orch.circuitforg?=
 =?UTF-8?q?e.tech?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Contributor2's example-node.tv has no WireGuard route to Heimdall's LAN (10.1.10.x),
so the <YOUR_HOST_IP>:7700 private address is unreachable from there.

Use the public cf-orch endpoint instead:
  GPU_SERVER_URL=https://orch.circuitforge.tech

Contributor's Huginn has WireGuard to Heimdall LAN — <YOUR_HOST_IP>:7700 stays correct.
Added both options to docker-standalone.sh for clarity.
---
 docker-standalone.sh |  8 ++++++--
 podman-standalone.sh | 10 ++++++----
 2 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/docker-standalone.sh b/docker-standalone.sh
index 5cbac72..7098fa8 100755
--- a/docker-standalone.sh
+++ b/docker-standalone.sh
@@ -85,13 +85,17 @@ TZ="${TZ:-America/Los_Angeles}"
 
 # ── Multi-agent diagnose pipeline ────────────────────────────────────────────
 # Enable the 5-stage ML pipeline to get smarter diagnose results.
-# Requires WireGuard connectivity to Heimdall (<YOUR_HOST_IP>) for LLM synthesis.
 #
-# For Contributor's instance (Huginn) — Heimdall's cf-orch via WireGuard:
+# If your host has WireGuard to Heimdall's LAN (e.g. Huginn):
 #   export GPU_SERVER_URL=http://<YOUR_HOST_IP>:7700
 #   export TURNSTONE_MULTI_AGENT_DIAGNOSE=true
 #   bash ~/turnstone/docker-standalone.sh
 #
+# If your host has no WireGuard to Heimdall (use public cf-orch endpoint):
+#   export GPU_SERVER_URL=https://orch.circuitforge.tech
+#   export TURNSTONE_MULTI_AGENT_DIAGNOSE=true
+#   bash ~/turnstone/docker-standalone.sh
+#
 # ML models are downloaded on first diagnose run and cached in HF_CACHE_DIR.
 # First run takes a few minutes (downloading ~400MB of CPU-only models).
 # Subsequent runs are instant (models served from hf-cache/).
diff --git a/podman-standalone.sh b/podman-standalone.sh
index 8955334..469c490 100755
--- a/podman-standalone.sh
+++ b/podman-standalone.sh
@@ -91,15 +91,17 @@ TZ=America/Los_Angeles
 # ML models are downloaded on first diagnose run and cached in HF_CACHE_DIR.
 # On a CPU-only host (no GPU) set TURNSTONE_EMBED_DEVICE=cpu (default).
 #
-# For Contributor2's instance (example-node.tv) — Heimdall's cf-orch via WireGuard:
-#   export GPU_SERVER_URL=http://<YOUR_HOST_IP>:7700
+# For Contributor2's instance (example-node.tv) — no WireGuard to Heimdall LAN,
+# use the public cf-orch endpoint instead:
+#   export GPU_SERVER_URL=https://orch.circuitforge.tech
 #   export TURNSTONE_MULTI_AGENT_DIAGNOSE=true
 #   sudo bash /opt/turnstone/podman-standalone.sh
 #
-# For Contributor's instance (Huginn) — same cf-orch via WireGuard:
+# For Contributor's instance (Huginn) — WireGuard reaches Heimdall LAN directly,
+# use docker-standalone.sh (not this script — Docker host):
 #   export GPU_SERVER_URL=http://<YOUR_HOST_IP>:7700
 #   export TURNSTONE_MULTI_AGENT_DIAGNOSE=true
-#   bash /opt/turnstone/podman-standalone.sh   (or rebuild Docker container)
+#   bash ~/turnstone/docker-standalone.sh
 
 # ── Turnstone container ───────────────────────────────────────────────────────
 # Image is built locally — no registry auto-update label.