No description
| Filename | Latest commit message | Latest commit date |
|---|---|---|
hermes
b2ba087a0c
- 03-storage: add 'comics' to the /tank/data/media structure and update the browse pointer (Komga now serves comics/mangas, not doujins). - 04-services: repoint app-komga bind mount from nsfw/05-literatures/doujins to /tank/data/media/comics; mark Komga as SFW manga/comics and LANraragi as NSFW doujins/comics. |
||
| hermes | ||
| 00-journey.md | ||
| 01-hardware.md | ||
| 02-network.md | ||
| 03-storage.md | ||
| 04-services.md | ||
| 05-local-llm-stack.md | ||
| 06-troubleshoots.md | ||
| 99-index.md | ||
| README.md | ||
Homelab Documentation
Single source of truth for the segmentum.app homelab infrastructure.
What This Covers
- Hardware specs, undervolts, physical layout
- Network topology (VPS, WireGuard, OpenWRT, Caddy)
- ZFS storage layout, mount points, dataset tuning
- All LXCs/VMs with IPs, ports, auth methods, bind mounts
- LLM stack (llama.cpp, llama-swap, OpenWebUI)
- Troubleshooting notes and root causes
Who Reads This
- Me — reference when something breaks at 2 AM
- Hermes — the homelab AI agent, reads these files to understand its environment
- LLM chat sessions — fed as context for debugging and planning
Structure
Files are ordered by dependency — each file only references concepts introduced earlier:
| File | Contents | Depends On |
|---|---|---|
01-hardware.md |
CPU, GPU, RAM, storage devices, case, PSU, UPS | — |
02-network.md |
ISP, OpenWRT bridges, WireGuard, Caddy, domains | Hardware for NICs |
03-storage.md |
ZFS pools, datasets, ARC, mount paths, backup | Hardware for drives |
04-services.md |
LXC/VM table, bind mounts, auth methods | Network (IPs) + Storage (mount paths) |
05-local-llm-stack.md |
llama.cpp, llama-swap, models, performance | Services + Storage (model paths) |
06-troubleshoots.md |
Cross-cutting fixes, root causes, commands | All above |
99-index.md |
Topic → file lookup table | All above |
hermes/bootstrap.md |
Mini system prompt for Hermes agent | All above |
How to Update
git clone git@git.segmentum.app:shandy/homelab-docs.git
# edit files...
git add .
git commit -m "update: description of changes"
git push