Architecture Decision Records
All significant architectural decisions for HomeKube are documented as ADRs (Architecture Decision Records). Each ADR captures the context, decision, alternatives considered, and consequences.
Index
| ADR |
Title |
Status |
Date |
| ADR-001 |
Minikube as Local Kubernetes Runtime |
Accepted |
2026-03-07 |
| ADR-002 |
FluxCD v2 for GitOps Continuous Delivery |
Accepted |
2026-03-07 |
| ADR-003 |
Single GitHub Monorepo |
Accepted |
2026-03-07 |
| ADR-004 |
Helm for Third-Party Charts, Kustomize for Overlays |
Accepted |
2026-03-07 |
| ADR-005 |
ingress-nginx as Ingress Controller |
Accepted |
2026-03-07 |
| ADR-006 |
cert-manager for TLS Certificate Automation |
Accepted |
2026-03-07 |
| ADR-007 |
kube-prometheus-stack for Observability |
Accepted |
2026-03-07 |
| ADR-008 |
Cilium as CNI and Network Policy Engine |
Accepted |
2026-03-07 |
| ADR-009 |
Keycloak for Identity Management and SSO |
Accepted (partly superseded by ADR-011) |
2026-03-07 |
| ADR-010 |
SOPS + GPG for Secrets Management |
Accepted |
2026-03-21 |
| ADR-011 |
Switch Keycloak to Official quay.io Image |
Accepted |
2026-03-21 |
| ADR-012 |
TLS for Keycloak and Grafana Ingresses |
Accepted |
2026-03-21 |
| ADR-013 |
prek for Pre-commit Hooks |
Accepted |
2026-03-21 |
| ADR-014 |
Flux Notifications → GitHub Commit Status |
Accepted |
2026-03-21 |
| ADR-015 |
Flux Image Automation |
Accepted |
2026-03-21 |
| ADR-016 |
Documentation Hosting via MkDocs, GitHub Pages, and In-Cluster Nginx |
Accepted |
2026-03-21 |
| ADR-017 |
Kyverno as Policy Engine for Admission Control |
Accepted |
2026-03-21 |
ADR Status Definitions
| Status |
Meaning |
| Proposed |
Under discussion, not yet implemented |
| Accepted |
Decision made and implemented |
| Deprecated |
Was accepted, no longer applies |
| Superseded |
Replaced by a newer ADR |