# Server App Configs

Podman deployment configuration for two homelab servers: Dankserver and Dankclaw.

## Targets

| Host | User | IP | Stack |
|------|------|----|-------|
| dankclaw | dank | 192.168.0.143 | AI, search, development, observability |
| dankserver | dank | 192.168.0.235 | media and library |

## Active Services

| Service | Host | Hostname | Port |
|---------|------|----------|------|
| RomM | dankserver | romm.dankserver.local | 8085 |
| Copyparty | dankserver | files.dankserver.local | 3923 |
| Calibre-Web | dankserver | books.dankserver.local | 8083 |
| SearXNG | dankclaw | search.dankclaw.local | 8081 |
| ComfyUI | dankclaw | comfyui.dankclaw.local | 8188 |
| OpenWebUI | dankclaw | chat.dankclaw.local | 3000 |
| Hermes | dankclaw | hermes.dankclaw.local | 8090 |
| Gitea | dankclaw | gitea.dankclaw.local | 3001 |
| Grafana | dankclaw | grafana.dankclaw.local | 3002 |
| Prometheus | dankclaw | prometheus.dankclaw.local | 9090 |

## Structure

- `dankserver/` — compose.yaml + Caddyfile + .env.example for the Dankserver stack
- `dankclaw/` — compose.yaml + Caddyfile + .env.example for the Dankclaw stack
- `shared/` — homepage, prometheus config, deploy helpers
- `scripts/` — deploy.sh and stack control scripts
- `docs/` — project knowledge base (Obsidian vault, wikilinks)
- `tests/` — bats test suite (see [[Testing Policy]])

## Deployment

See [docs/Architecture/Deployment Flow.md](docs/Architecture/Deployment Flow.md). Run `./scripts/deploy.sh <dankclaw|dankserver>` after pushing committed changes.

## Knowledge Base

The `docs/` directory is an Obsidian vault. Start at [docs/index.md](docs/index.md).

## Testing

Run `./tests/run.sh` before every push. See [docs/Architecture/Testing Policy.md](docs/Architecture/Testing Policy.md).

## Also See

- [vllmScripts](http://dankclaw:3000/dank/vllmScripts) (local: `../vllmScripts`) —
  the model-serving scripts this stack consumes: `frank-default-large`
  (llama.cpp PP head, `:7770`, backend of OpenWebUI) and
  `frank-default-small` (FastFlowLM NPU, `:52625`)