Table of contents
Homelab knowledge base
Scope and evidence
This Wiki records repository-declared facts about the Homelab. The entries describe intended configuration, not live health. Unless a page says otherwise, the facts were checked against main at commit b38b25d on 2026-10-27. Terraform and application configuration remain the sources of desired state; source paths are listed with each topic.
The Wiki contains no credentials, token values, private keys, Terraform state, or decoded Kubernetes Secret data. It records facts rather than operational procedures. Operational procedures belong with the relevant task skill.
Dynamic identity state is not copied into a static inventory. Inspect Authentik and application configuration for configured role mappings, and query Authentik for live membership.
Topics
- Platform architecture — cluster, network paths, DNS, ingress, and vCluster.
- Service inventory — application endpoints, access mechanisms, and dependencies.
- Storage and state — Longhorn, NAS, RustFS, OpenBao, and Terraform state.
- PR previews — shared preview architecture and application-facing behavior.
Repository model
Root Terraform files wire modules under modules/; charts/ contains the shared preview chart; .forgejo/ contains central workflows; templates/ contains the opt-in preview workflow; .agents/skills/ contains task-specific agent skills and references. The root README is the repository overview and getting-started page.