# System Documentation

Hardware, operating system, and network documentation for the Frank Program
infrastructure. dankware is the primary workstation; Dankserver and Dankclaw are
the llama.cpp inference servers it talks to.

## Local System

- [System Overview](/system/dankware/index.md) — dankware: Alienware m16 R2 laptop running CachyOS with Niri Wayland.
- [Hardware Specifications](/system/dankware/hardware.md) — CPU, GPU, memory, storage, network controllers, and PCI devices for dankware.
- [Display Configuration](/system/dankware/displays.md) — Three-monitor setup: dual Samsung Odyssey G75F (portrait) plus the internal BOE panel.
- [Network Interfaces](/system/dankware/network.md) — Wi-Fi (Intel BE202), built-in Ethernet (Killer E3000), USB Ethernet, and local network topology.

## 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[dankware - Alienware m16 R2]
        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 projects on dankware)

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.