# 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) — Main-model inference server at 192.168.0.235:7770, serving `frank-archon` (radiance Qwen3.8-Flash-Next, 200K ctx). AMD Ryzen 7 7700X, 2× Radeon AI PRO R9700, Ubuntu 26.04.
- [Dankclaw](/system/dankclaw.md) — Secondary inference + services box at 192.168.0.143: `frank-dragoon` (:7770, halogen-flash-server on the Strix Halo iGPU) and `frank-zealot` (:7771, llama.cpp on the RTX 3090). AMD Ryzen AI MAX+ 395, Ubuntu 26.04.

## 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-archon]
        F[dankclaw<br/>192.168.0.143:7770 dragoon<br/>:7771 zealot]
    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** — deploy repo + Obsidian vault, on this workstation at `~/Projects/serverAppConfig/` with docs in `~/Projects/serverAppConfig/serverAppConfigs-docs/` (root `index.md` at the vault top — the old `docs/` prefix is gone). Podman deployment configuration for both servers: compose/quadlet files, Caddy reverse proxy, deploy scripts, bats tests, and the vault service docs (Dankclaw, Dankserver, Architecture, Infrastructure) — **plus the LLM inference fleet** (merged from the former `vllmScripts` repo on 2026-08-22, history preserved): radiance frank-archon on Dankserver (:7770), halogen frank-dragoon (:7770) and llama.cpp frank-zealot (:7771) on Dankclaw. The vault's `LLM/` runbooks are the deploy-side source of truth; this bundle documents the agent/harness side.

## Related

- [Root Index](/index.md) — bundle navigation.
- [Engineering](/engineering/index.md) — best practices behind the ops.