# 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.