remove misleading Kamatera .deploy.conf; document local-only deploy in DEPLOY.md

518f2cf6000da2b15c23488efdb8dfce1940d473 · 2026-08-19 11:38:37 -0700 · steve

Files touched

D .deploy.conf
A DEPLOY.md

Diff

commit 518f2cf6000da2b15c23488efdb8dfce1940d473
Author: steve <steve@designerwallcoverings.com>
Date:   Wed Aug 19 11:38:37 2026 -0700

    remove misleading Kamatera .deploy.conf; document local-only deploy in DEPLOY.md
---
 .deploy.conf |  5 -----
 DEPLOY.md    | 20 ++++++++++++++++++++
 2 files changed, 20 insertions(+), 5 deletions(-)

diff --git a/.deploy.conf b/.deploy.conf
deleted file mode 100644
index 4708f9a..0000000
--- a/.deploy.conf
+++ /dev/null
@@ -1,5 +0,0 @@
-PROJECT_NAME=qwen38-viewer
-DEPLOY_PATH=/root/Projects/qwen38-viewer
-HEALTH_URL=http://127.0.0.1:9821/health
-# NOTE: model runs in Ollama on macstudio3; this app must stay co-located there.
-# Public exposure = Cloudflare tunnel (GATED), not a Kamatera deploy.
diff --git a/DEPLOY.md b/DEPLOY.md
new file mode 100644
index 0000000..f2fdfac
--- /dev/null
+++ b/DEPLOY.md
@@ -0,0 +1,20 @@
+# Deploy — qwen38-viewer
+
+**This app has NO remote/Kamatera deploy.** It must run on macstudio3, co-located
+with Ollama (the model lives in this box's Ollama on :11434; a remote host can't
+reach it). The public URL `https://qwen38.agentabrams.com` is a Cloudflare tunnel
+(`dw-followup`, ingress in `~/.cloudflared/followup.yml`) → `127.0.0.1:9821`.
+
+So "deploy" = **test-gate → reload the local pm2 process → smoke-test the public host.**
+Do NOT run `/deploy` (it would rsync to Kamatera, which is inapplicable here).
+
+```sh
+cd ~/Projects/qwen38-viewer
+npm test || exit 1                 # deploy gate — 18 regressions, must pass
+pm2 restart qwen38-viewer --update-env
+pm2 save                           # persist across reboot
+# smoke-test the public hostname:
+curl -s -o /dev/null -w '%{http_code}\n' https://qwen38.agentabrams.com/health   # 200
+```
+
+Auth + model config live in the pm2 env (USERS / CODES / KEEP_ALIVE), not in git.

← 114f772 add npm test: 18 regression checks (auth matrix incl no-colo · back to Qwen38 Viewer · 5x: two clean sweeps (7/7, 0 defects) — REPORT.md 6ce074b →