# Infrastructure Docs Repo

## Location

- Filesystem: `~/dev/claude/docs/infrastructure/homelab/`
- Repo: `gitea.oreillyit.nz/homelab/infrastructure-docs`
- SSH remote: `git@gitea.oreillyit.nz-homelab:homelab/infrastructure-docs.git`

## Purpose

Authoritative catalog of all systems in the homelab environment. Unlike MEMORY.md (accumulated learnings) or CLAUDE.md (project conventions), this is a **maintained map** — updated when systems are added/removed, not accumulated over time.

Answers: "What depends on X?", "What breaks if Y goes down?", "What manages Z?"

## Structure

- `INDEX.md` — thin index listing all system files, grouped by category
- One `.md` per system (e.g., `cilium.md`, `traefik.md`, `authelia.md`)
- Each file: what it does, network details, depends on, depended on by, managed by
- Parent `docs/infrastructure/` supports multiple locations (future: `customer-site-x/`)

## Categories

- Physical/Hosting: proxmox, vps, bootstrap-vm
- Cluster Core: talos, cilium, argocd
- Storage: proxmox-csi, proxmox-ccm
- Networking: wireguard, caddy, traefik, coredns, dnsmasq
- Identity: authelia, headscale
- Platform: gitea, email-relay, homepage, cert-pipeline
- Applications: octopus-deploy, external-services

## Source projects

Documents systems from both `cluster-bootstrap` and `cluster-apps`. Shared across projects — not inside any single project repo.

## When to update

- Adding/removing/replacing a system
- Dependencies change (new service depends on Authelia, etc.)
- Major version upgrades worth noting