Frank
f1e0b6583d
Frank's call: no per-host graveyard. The four /system/dankware/ pages carried two pieces of knowledge that outlive the box, and one that does not. Distilled: - omp-docs/system/network.md (new) — LAN topology plus the multi-link resolver law: a client with two +DefaultRoute links flaps its DNS, and the fix is a static per-connection resolver, not resolved.conf. Keeps the flush-caches-loop verification, because one successful dig proves nothing. - omp-docs/tools/niri/displays.md (new) — the multi-monitor rig: portrait transforms, absolute positions, auto-placed third panel, the iGPU render-node pin, and the three failure modes (duplicate output blocks, positions that do not reflow, a mode the panel cannot drive). Dropped: the machine's own spec sheet (CPU/GPU/PCI/NVMe inventory for a box Frank sold) and its quick-facts table. The OS and userspace facts it repeated already live in tools/cachyos.md. omp-docs/system/dankware/ moved to .AGENTTRASH/20260928-retired-workstation/ (not deleted; git history holds it too). system/index.md and the niri index repoint; niri's [[displays]] wikilink now resolves to the new page instead of the trashed one. kb-lint: 0 violations.
51 lines
2.3 KiB
Markdown
51 lines
2.3 KiB
Markdown
# System Documentation
|
|
|
|
Hardware, operating system, and network documentation for the Frank Program
|
|
infrastructure. A client workstation runs the desktop stack; Dankserver and
|
|
Dankclaw are the inference servers it talks to.
|
|
|
|
## Local System
|
|
|
|
- [Network](/system/network.md) — LAN topology, and the client-side DNS pinning rule for workstations with both Wi-Fi and Ethernet.
|
|
- [Workstation stack](/tools/cachyos.md) — operating system, packages, and userspace; [niri](/tools/niri/index.md) for the compositor and display rig.
|
|
|
|
## Network Systems
|
|
|
|
- [Dankserver](/system/dankserver.md) — Primary llama.cpp inference server at 192.168.0.235:7770, serving `frank-default-small` (163,840-token context). AMD Ryzen 7 7700X, RTX 3090, Ubuntu 26.04.
|
|
- [Dankclaw](/system/dankclaw.md) — Secondary inference server at 192.168.0.143:7770, serving `frank-default-large` (262,144-token context). AMD Ryzen AI MAX+ 395 (Strix Halo), Ubuntu 26.04, ROCm.
|
|
|
|
## Infrastructure Diagram
|
|
|
|
```mermaid
|
|
graph TB
|
|
subgraph Local[Workstation - CachyOS + Niri]
|
|
A[Niri Wayland]
|
|
B[Noctalia Shell]
|
|
C[Ghostty Terminal]
|
|
D[Pi Agent]
|
|
end
|
|
|
|
subgraph Network[192.168.0.0/24]
|
|
E[dankserver<br/>192.168.0.235:7770<br/>frank-default-small]
|
|
F[dankclaw<br/>192.168.0.143:7770<br/>frank-default-large]
|
|
end
|
|
|
|
D --> E
|
|
D --> F
|
|
C --> D
|
|
B --> C
|
|
A --> B
|
|
```
|
|
|
|
## Related Knowledge Bases (sibling project repos)
|
|
|
|
The fleet has one sibling OKF knowledge base outside this bundle. Read it for
|
|
deployment and inference details. This bundle links to it from the server pages.
|
|
|
|
* **serverAppConfigs** — `/home/dank/Projects/serverAppConfigs/` (index: `/home/dank/Projects/serverAppConfigs/docs/index.md`). Podman deployment configuration for both servers: compose files, Caddy reverse proxy, deploy scripts, bats tests, and the Obsidian-vault service docs (Dankclaw, Dankserver, Architecture, Infrastructure) — **plus the LLM inference fleet** (merged from the former `vllmScripts` repo on 2026-08-22, history preserved): llama.cpp on Dankserver (:7770, `frank-default-small`) and CIRU ROCmFPX llama.cpp on Dankclaw (:7770, `frank-default-large`). LLM fleet docs: `docs/LLM/index.md`; deploy runbook: `docs/LLM/deployment.md`.
|
|
|
|
## Related
|
|
|
|
- [Root Index](/index.md) — bundle navigation.
|
|
- [Engineering](/engineering/index.md) — best practices behind the ops.
|