dank/serverAppConfigs
1
0
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity

README + .gitignore: one repo, two workloads

Browse Source 
README: merged service table (stack + LLM), structure incl. old/ and
docs/LLM/, unified deploy note, merge note.
.gitignore: merged both files; !scripts/*.env exception for the LLM
tunables (paths and numbers, never credentials); .obsidian/,
__pycache__/, .venv/ from the vllmScripts side.
This commit is contained in:
Frank
2026-08-22 15:49:44 -07:00
parent 99c7255db5
commit 2b115ad378
2 changed files with 38 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.gitignore
+12
View File
@@ -2,6 +2,8 @@
.env
*.env
!.env.example
# LLM fleet tunables (paths and numbers, never credentials)
!scripts/*.env
# pi subagent artifacts
.pi-subagents/
@@ -9,6 +11,16 @@
# Agent trash
.AGENTTRASH/
# Python
__pycache__/
*.pyc
# Virtual environments
.venv/
# Obsidian editor state
.obsidian/
# Editor/OS noise
*.swp
.DS_Store
README.md
+26 -17
View File
@@ -1,13 +1,19 @@
# Server App Configs
Podman deployment configuration for two homelab servers: Dankserver and Dankclaw.
The single repository for the two homelab servers: the Podman container
stacks **and** the LLM inference fleet. One repo, one checkout per host,
one deploy script.
> 2026-08-22: the former `vllmScripts` repository (LLM fleet) is merged
> into this repo with its full git history. See AGENTS.md for the merge
> note.
## Targets
| Host | User | IP | Stack |
|------|------|----|-------|
| dankclaw | dank | 192.168.0.143 | AI, search, development, observability |
| dankserver | dank | 192.168.0.235 | media and library |
| Host | User | IP | Podman stack | LLM service | LLM port |
|------|------|----|--------------|-------------|----------|
| dankserver | dank | 192.168.0.235 | media and library | frank-default-small (llama.cpp, Qwen3.6-35B-A3B) | 7770 |
| dankclaw | dank | 192.168.0.143 | AI, search, development, observability | frank-default-large (CIRU ROCmFPX, Qwen3.8-27B) | 52625 |
## Active Services
@@ -16,6 +22,7 @@ Podman deployment configuration for two homelab servers: Dankserver and Dankclaw
| RomM | dankserver | romm.dankserver.local | 8085 |
| Copyparty | dankserver | files.dankserver.local | 3923 |
| Calibre-Web | dankserver | books.dankserver.local | 8083 |
| frank-default-small | dankserver | — (bare endpoint) | 7770 |
| SearXNG | dankclaw | search.dankclaw.local | 8081 |
| ComfyUI | dankclaw | comfyui.dankclaw.local | 8188 |
| OpenWebUI | dankclaw | chat.dankclaw.local | 3000 |
@@ -23,31 +30,33 @@ Podman deployment configuration for two homelab servers: Dankserver and Dankclaw
| Gitea | dankclaw | gitea.dankclaw.local | 3001 |
| Grafana | dankclaw | grafana.dankclaw.local | 3002 |
| Prometheus | dankclaw | prometheus.dankclaw.local | 9090 |
| frank-default-large | dankclaw | — (bare endpoint) | 52625 |
## 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)
- `scripts/` — `deploy.sh` (unified: stack + LLM), LLM serve scripts, systemd units, env tunables, bench harnesses
- `old/` — retired PP/NPU-era LLM scripts (reference only)
- `docs/` — project knowledge base (Obsidian vault, wikilinks). `docs/LLM/` is the LLM fleet
- `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.
See [docs/Architecture/Deployment Flow.md](docs/Architecture/Deployment%20Flow.md)
and [docs/LLM/deployment.md](docs/LLM/deployment.md). Run
`./scripts/deploy.sh <dankclaw|dankserver>` after pushing committed changes.
It pushes, pulls on the target, restarts the podman stack and the LLM
service, and checks both health endpoints.
## Knowledge Base
The `docs/` directory is an Obsidian vault. Start at [docs/index.md](docs/index.md).
The `docs/` directory is an Obsidian vault. Start at
[docs/index.md](docs/index.md). The LLM fleet knowledge base lives at
[docs/LLM/index.md](docs/LLM/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`)
Run `./tests/run.sh` before every push. See
[docs/Architecture/Testing Policy.md](docs/Architecture/Testing%20Policy.md).