Frank
e3eb5334cb
- Dankserver stack: RomM, Copyparty, Calibre-Web, node-exporter - Dankclaw stack: Gluetun VPN (SearXNG tunnel), SearXNG+Valkey, ComfyUI (CPU backend), OpenWebUI, Hermes, Gitea+Postgres (migrated), Caddy reverse proxy, Grafana+Prometheus+Loki+Alloy observability - Caddyfiles with .local hostname convention and basicauth homepage - bind-mount storage policy, no named volumes - deploy.sh mirroring vllmScripts git workflow (push -> pull -> restart -> health) - docs/ Obsidian vault: per-service docs from frank-default-small research subagents (promtail EOL -> Alloy; gitea SECRET_KEY preservation; ComfyUI --cpu) - bats test suite at 6 seams — 22 tests green
64 lines
2.2 KiB
Markdown
64 lines
2.2 KiB
Markdown
# Server App Configs
|
|
|
|
Podman deployment configuration for two homelab servers: Dankserver and Dankclaw.
|
|
|
|
This repository tracks the container stacks for both hosts. Git is the single source of truth. Edits flow through this repo, then deploy to the targets with `scripts/deploy.sh`. This mirrors the workflow of the `vllmScripts` repository.
|
|
|
|
## Hosts
|
|
|
|
| Host | IP | Role | OS |
|
|
|------|----|------|----|
|
|
| Dankserver | 192.168.0.235 | Media & library stack | Ubuntu 24.04 |
|
|
| Dankclaw | 192.168.0.143 | AI, search & development stack | Ubuntu 26.04 |
|
|
|
|
## Stacks
|
|
|
|
- [[Dankserver Stack]] — RomM, Copyparty, Calibre, Calibre-Web, Caddy
|
|
- [[Dankclaw Stack]] — SearXNG (via Gluetun), ComfyUI, OpenWebUI, Hermes, Gitea, Grafana, Prometheus, Caddy
|
|
|
|
## Architecture
|
|
|
|
- [[Network Architecture]] — Caddy reverse proxy, hostname routing, Gluetun VPN path
|
|
- [[Storage Policy]] — bind mounts, data locations, ownership
|
|
- [[Deployment Flow]] — git-based deploy, target map, health checks
|
|
- [[Testing Policy]] — the test seams and how to run them
|
|
|
|
## Dankserver Services
|
|
|
|
- [[RomM]] — retro game manager
|
|
- [[Copyparty]] — file sharing and streaming
|
|
- [[Calibre]] — e-book library engine
|
|
- [[Calibre-Web]] — e-book web frontend
|
|
|
|
## Dankclaw Services
|
|
|
|
- [[SearXNG]] — privacy metasearch (VPN-routed)
|
|
- [[Gluetun]] — the VPN tunnel container
|
|
- [[Valkey]] — SearXNG cache and limiter store
|
|
- [[ComfyUI]] — node-based AI image generation (CPU)
|
|
- [[OpenWebUI]] — chat UI for local LLMs
|
|
- [[Hermes]] — the Nous Research agent
|
|
- [[Gitea]] — Git hosting (migrated)
|
|
- [[Postgres]] — Gitea database backend
|
|
|
|
## Infrastructure
|
|
|
|
- [[Caddy]] — reverse proxy and TLS
|
|
- [[Homepage]] — password-protected service index
|
|
- [[Observability]] — Grafana, Prometheus, Loki, Alloy
|
|
- [[Grafana]] — dashboards
|
|
- [[Prometheus]] — metrics collection
|
|
- [[Node-Exporter]] — host metrics
|
|
- [[Loki]] — log storage
|
|
- [[Alloy]] — log shipping (replaces Promtail)
|
|
|
|
## Research
|
|
|
|
- [[Service Research Brief]] — consolidated subagent research behind these pages
|
|
- [[Backblaze Integration]] — off-site backup plan (future)
|
|
|
|
## See Also
|
|
|
|
- [vllmScripts repository](../vllmScripts/docs/index.md) — the deployment model this repo follows
|
|
- [[AGENTS.md]] — repository rules
|