docs: establish domain model, MVI spec, and environment reference
Capture the design work for the NixOS migration before any implementation: - .claude/CONTEXT.md: domain glossary (Host, Module, Skeleton, Auto-loader, Enable convention, unstable/stable overlay) - .claude/adr/0001-sops-nix-for-secrets.md: secrets tooling decision - .claude/spec/laptop-mvi.md: frozen minimum-viable-install spec for neogaia - reference/: read-only snapshot of the current CachyOS configs (secrets and state excluded), plus ENVIRONMENT.md profiling the live environment to guide replication
This commit is contained in:
10
.claude/adr/0001-sops-nix-for-secrets.md
Normal file
10
.claude/adr/0001-sops-nix-for-secrets.md
Normal file
@@ -0,0 +1,10 @@
|
||||
# Use sops-nix for secrets
|
||||
|
||||
The repo is public, so no secret — including password hashes and the WireGuard/ProtonVPN key — may be committed in plaintext. We manage all secrets with **sops-nix**: encrypted into the repo and decrypted per-host at activation via an age key derived from each machine's SSH host key.
|
||||
|
||||
We chose sops-nix over agenix for its multi-recipient encryption (one secret readable by both a host and the admin laptop) and its grouped-file editing workflow, which scale better across the planned five hosts with a mix of shared and per-host secrets. The cost is slightly more upfront machinery than agenix's one-file-per-secret model.
|
||||
|
||||
## Consequences
|
||||
|
||||
- User/root passwords use `hashedPasswordFile` backed by a sops secret, never a committed hash.
|
||||
- Each new host must have its SSH host public key registered as a recipient before it can decrypt its secrets.
|
||||
Reference in New Issue
Block a user