dtoro
bb5c0717a1
Problem: the narrative docs lacked an enforceable style standard, and
agent-facing instruction (OIKOS/CAVEMAN/CONTRIBUTING) was interleaved with
human content at the repo root.
Change:
- Add .agents/shared/{writing-style,llm-wiki}.md — a lint-checkable prose
standard (with an imperative-voice exception for runbooks/recipes) and the
sources/wiki/index/log layer model.
- Move CAVEMAN.md -> .agents/shared/caveman.md,
CONTRIBUTING.md -> .agents/shared/page-templates.md,
OIKOS.md -> .agents/OIKOS.md; leave thin root stubs so old links resolve.
- Add .agents/domains/{knowledge,operations}/schema.md; operations schema
codifies "plans always live in plans/".
- Repoint live references (AGENTS, README, GLOSSARY, OIKOS) and fix OIKOS.md's
internal relative links for its new depth.
Risk: none to the operational substrate — inventory.yaml, hosts/*.yaml,
oikos/, mcp/, secrets/, bin/ untouched (verified via git status).
Verification: relative-link check across .agents/ clean; substrate churn empty.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
33 lines
2.5 KiB
Markdown
33 lines
2.5 KiB
Markdown
# Glossary
|
|
|
|
Terms and abbreviations used throughout the homelab wiki.
|
|
|
|
| Term | Meaning |
|
|
|------|---------|
|
|
| **Authentik** | SSO/identity provider. Core runs on the VPS; forward-auth outpost at LXC 106 on hubris |
|
|
| **Caddy** | Reverse proxy (LXC 121). Terminates TLS for every `*.hubris.network` hostname |
|
|
| **Caveman** | Terse communication standard for agent responses — no filler, keep substance |
|
|
| **Forward-auth** | Caddy snippet that delegates authentication to an Authentik outpost. Protects web UIs like qBit, SABnzbd |
|
|
| **Gitea** | Git server at `git.hubris.network`. Hosts all tracked config repos |
|
|
| **Gluetun** | WireGuard VPN sidecar on arriman. All \*arr traffic routes through it |
|
|
| **HAOS** | Home Assistant Operating System. VM 108 on hubris |
|
|
| **Hubris** | Primary Proxmox VE node (GMKtec NucBox M6 Ultra). PVE hostname, cluster member 1 |
|
|
| **LXC** | Linux Container (Proxmox). VM-like isolation without a full OS kernel |
|
|
| **LVM-thin** | Thin-provisioned logical volume manager. Used for all container/VM storage |
|
|
| **MCP** | Model Context Protocol (MCP server at `mcp.hubris.network`). Structured tools for agents to query homelab state |
|
|
| **Mesh** | Overlay VPN for off-LAN connectivity. Netbird is current; Tailscale is legacy |
|
|
| **Netbird** | Preferred mesh VPN. VPS hosts the management plane; all homelab nodes are members |
|
|
| **OIDC** | OpenID Connect. Protocol used by Authentik for SSO login flows |
|
|
| **Oikos** | Agent operating model ([.agents/OIKOS.md](.agents/OIKOS.md)). OODA loop, risk classes, policy, ontology |
|
|
| **PVE** | Proxmox Virtual Environment — the hypervisor on both hubris and strong |
|
|
| **SOPS** | `sops` — Mozilla SOPS. Encrypts secrets with age keys so they live in the git repo |
|
|
| **Strong** | Secondary Proxmox VE node. Cluster member 2 (hostname `strong`, nickname ludo/ludo-mini) |
|
|
| **Traefik** | Reverse proxy on IONOS VPS. Serves `*.hubris.network` to the public internet |
|
|
| **VAAPI** | Video Acceleration API. Intel/AMD GPU-based hardware transcode for Jellyfin |
|
|
| **VPS** | Virtual Private Server at IONOS (`82.165.190.79`). Runs Authentik core + Netbird management |
|
|
| **\\*arr** | Media automation suite: Sonarr (TV), Radarr (movies), Lidarr (music), Prowlarr (indexer), Bazarr (subtitles), Readarr (books — not in use) |
|
|
|
|
## See also
|
|
|
|
- [Infrastructure index](infrastructure/index.md) — cross-cutting systems each with their own doc page
|
|
- [OIKOS operating model](.agents/OIKOS.md) — agent policy, risk classes, lifecycle |