docs: rename docs/ -> serverAppConfigs-docs/ per system-wide PROJECTNAME-docs convention

All in-repo path references (AGENTS.md, README, old scripts, report artifacts, test code paths) rewritten in the same commit; focused-test map extended for .gitignore, old/scripts/*, dankclaw/comfyui/*, and report/* per this repo's own convention ('add one before committing'). Obsidian wikilinks are title-based and unaffected.
2026-08-28 02:20:06 -07:00
1 parent 6d4a96a423
commit 5829a0bfe8
@@ -0,0 +1,73 @@
+---
+type: reference
+title: Dankclaw Stack
+description: Service inventory and routing overview for the Dankclaw AI, development, and observability host.
+tags:
+  - dankclaw
+  - services
+  - containers
+  - caddy
+timestamp: 2026-08-26
+---
+
+# Dankclaw Stack
+
+Dankclaw (192.168.0.143) runs the AI, search, and development stack. It
+hosts the LLM inference endpoint (`frank-default-large`, `:7770`, CIRU
+ROCmFPX llama.cpp), the agent tools, the privacy search, and the
+observability stack. The llama.cpp endpoint (`frank-default-small`,
+`:7770`) runs on Dankserver (192.168.0.235).
+
+```mermaid
+graph LR
+    U[User] --> C[Caddy :80/:443]
+    C --> O[OpenWebUI]
+    C --> S[SearXNG]
+    C --> G[Gitea]
+    C --> F[ComfyUI]
+    C --> D[Grafana]
+    S --> V[Gluetun VPN]
+    O --> L[llama.cpp dankserver :7770]
+    O --> H[Hermes]
+    O --> E[CIRU llama.cpp :7770]
+```
+
+## Services
+
+| Service | Hostname | Port | Docs |
+|---------|----------|------|------|
+| SearXNG | search.dankclaw.local | 8081 | [[SearXNG]] |
+| ComfyUI | comfyui.dankclaw.local | 8188 | [[ComfyUI]] |
+| OpenWebUI | chat.dankclaw.local | 3005 | [[OpenWebUI]] |
+| Hermes | hermes.dankclaw.local | 8090 | [[Hermes]] |
+| Gitea | gitea.dankclaw.local | 3000 | [[Gitea]] |
+| Grafana | grafana.dankclaw.local | 3002 | [[Grafana]] |
+| Prometheus | prometheus.dankclaw.local | 9090 | [[Prometheus]] |
+| Homepage | dankclaw.local | 80/443 | — |
+| frank-default-large (host service, Dankclaw) | — | 7770 | [[deployment]] |
+| frank-default-small (host service, Dankserver) | — | 7770 | [[deployment]] |
+
+The last two rows are bare-metal systemd services, not containers. This
+repo owns their scripts, units, and knowledge base (see
+[serverAppConfigs-docs/LLM/index.md](../LLM/index.md)). Current mapping (2026-08-22):
+`frank-default-large` runs the CIRU ROCmFPX llama.cpp on Dankclaw;
+`frank-default-small` runs the upstream llama.cpp on Dankserver.
+
+## Boot Persistence
+
+The Gitea database and server, the SearXNG trio (gluetun, searxng, valkey), open-webui, Pi-hole, and Caddy run as Quadlet units, so they start at boot. Caddy left `compose.yaml` on 2026-08-26 after a reboot exposed that bare compose containers never come back; see [[Caddy]] for the unit and the incident. The former standalone Gitea Caddy unit is retired. User linger is on. ComfyUI runs as a systemd unit around a bare process. The remaining services in the table are defined in `compose.yaml` and are not yet boot-persistent — per AGENTS.md (Boot Persistence & Self-Healing) they each need a quadlet before they may be considered reliably deployed.
+
+Deploy the SearXNG trio with `scripts/deploy-searxng-quadlet.sh dankclaw`, open-webui with `scripts/deploy-open-webui-quadlet.sh dankclaw`, and Pi-hole with `scripts/deploy-pihole-quadlet.sh dankclaw`. The Gitea units install to `~/.config/containers/systemd/` (see [[Gitea]]); Caddy is deployed through `scripts/deploy.sh dankclaw --service caddy`.
+
+## Routing Rules
+
+- SearXNG outbound traffic exits through the [[Gluetun]] VPN container.
+- Every other service uses the normal LAN route.
+- The homepage lists all services with status.
+
+## See Also
+
+- [[index]] — repository index
+- [[Network Architecture]] — routing and proxy
+- [[Observability]] — Grafana, Prometheus, logs
+- [LLM fleet knowledge base](../LLM/index.md) — the model-serving endpoints on this host