Files

T

Frank f1e0b6583d docs: distill the retired workstation's KB pages into general pages

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.

2026-09-28 16:15:57 -07:00

2.3 KiB

Raw Blame History

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 — LAN topology, and the client-side DNS pinning rule for workstations with both Wi-Fi and Ethernet.
Workstation stack — operating system, packages, and userspace; niri for the compositor and display rig.

Network Systems

Dankserver — 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 — 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

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

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.

Root Index — bundle navigation.
Engineering — best practices behind the ops.

2.3 KiB Raw Blame History

System Documentation

Local System

Network Systems

Infrastructure Diagram

Related Knowledge Bases (sibling project repos)

Related

2.3 KiB

Raw Blame History