Glossary

Terms these docs use before defining them.

Homelab-specific names and the jargon that shows up without introduction.

TermWhat it means here
BifrostThe Hetzner VPS that acts as the public edge. Named after the Norse rainbow bridge. Runs Traefik, Authentik and the NetBird server under Docker Compose — see Hetzner Bifrost
wt0The WireGuard interface NetBird creates. It is NOARP/POINTOPOINT, which is why it must never appear in Cilium's device list — see Network Flow
k8s-routing-peerThe NetBird peer name of the in-cluster netbird-peer pod. It advertises 192.168.1.0/24 into the mesh so Bifrost can reach cluster services
Pattern A / Pattern BThe two ways a pod consumes an OpenBao secret. A mounts it as a file only; B additionally syncs a Kubernetes Secret. Defined in Secrets
ForwardAuthTraefik middleware that asks Authentik whether a request is authenticated before proxying it. Public services either use it or handle their own auth
schematicA Talos image built by factory.talos.dev with a specific set of system extensions. This cluster uses two: a base one and a GPU one
manifests branchv0.1.7-manifests. CI synthesizes CDK8s output and force-pushes it there; Argo CD watches it. Never edited by hand
share-managerThe NFS server pod Longhorn starts for each RWX volume, letting several pods attach at once
VMAgent / VMAlert / VMSingleVictoriaMetrics components: the scraper, the rule evaluator, and the single-node store. This cluster does not run cluster mode
time-slicingSplitting one physical GPU into several schedulable nvidia.com/gpu units. It divides compute time, not VRAM — see GPU
sm_120The CUDA compute capability of the RTX 5070 Ti (Blackwell). It needs CUDA 12.8 or newer, which constrains which container images will run
CDK8sGenerates Kubernetes YAML from Go. Every workload here is Go code, not hand-written YAML — see CDK8s
SOPS / ageThe encryption used for secrets/bootstrap.sops.yaml, which is safe to commit. age is the key format; sops is the tool
src()A Zola shortcode in these docs that links to a file in the repo at the right release ref — see This Documentation Site