# kensan-lab > Enterprise-grade Kubernetes on bare-metal — a reference architecture for platform engineering. Enterprise-grade Kubernetes on bare-metal — a reference architecture for platform engineering. Argo CD GitOps, Istio service mesh, Cilium CNI, Vault, Keycloak, Backstage, and full observability (Prometheus, Grafana, Loki, Tempo), running on Raspberry Pis and a mini PC. ## Overview - [Home](https://yu-min3.github.io/kensan-lab/index.md) - [Showcase](https://yu-min3.github.io/kensan-lab/showcase/index.md) ## Try it in one command - [Try it in one command](https://yu-min3.github.io/kensan-lab/getting-started/try-it-with-kind/index.md) - [How the kind environment works](https://yu-min3.github.io/kensan-lab/getting-started/kind-explained/index.md) - [How the explore layer is built](https://yu-min3.github.io/kensan-lab/getting-started/explore-layer/index.md) ## Architecture - [Infrastructure](https://yu-min3.github.io/kensan-lab/architecture/index.md) - [Argo CD](https://yu-min3.github.io/kensan-lab/architecture/argocd/index.md) - [Golden Path](https://yu-min3.github.io/kensan-lab/architecture/backstage-golden-path/index.md) - [Cloudflare Tunnel & Access](https://yu-min3.github.io/kensan-lab/architecture/cloudflare-tunnel/index.md) - [Cluster health monitoring](https://yu-min3.github.io/kensan-lab/architecture/cluster-health-monitoring/index.md) - [Koubou App contract](https://yu-min3.github.io/kensan-lab/architecture/koubou-lan-entry/index.md) - [Namespace & label contract](https://yu-min3.github.io/kensan-lab/architecture/namespace-label-design/index.md) - [Network policy](https://yu-min3.github.io/kensan-lab/architecture/network-policy-guide/index.md) - [Policy enforcement](https://yu-min3.github.io/kensan-lab/architecture/policy-enforcement/index.md) - [Storage (Longhorn)](https://yu-min3.github.io/kensan-lab/architecture/storage/index.md) - [Auth: one IdP, authenticate at the gateway, apps trust headers](https://yu-min3.github.io/kensan-lab/architecture/auth/index.md) - [Backstage: the platform's front door, golden paths instead of tickets](https://yu-min3.github.io/kensan-lab/architecture/backstage/index.md) - [Network: Cilium for L3/4, Istio for L7, unified by zero-trust](https://yu-min3.github.io/kensan-lab/architecture/network/index.md) - [Observability: three pillars through one pipe, watchers watching the watchers](https://yu-min3.github.io/kensan-lab/architecture/observability/index.md) - [Policy: one engine, reports before gates](https://yu-min3.github.io/kensan-lab/architecture/policy/index.md) - [Secrets: Vault at the core, four delivery methods, one escape hatch](https://yu-min3.github.io/kensan-lab/architecture/secrets/index.md) ## Auth & secrets - [ArgoCD ↔ Keycloak (Path B)](https://yu-min3.github.io/kensan-lab/auth/argocd-keycloak-integration/index.md) - [Backstage SSO via oauth2-proxy — superseded by ADR-022](https://yu-min3.github.io/kensan-lab/auth/backstage-sso-design/index.md) - [Gateway OIDC (Path A)](https://yu-min3.github.io/kensan-lab/auth/gateway-oidc/index.md) - [oauth2-proxy](https://yu-min3.github.io/kensan-lab/auth/oauth2-proxy/index.md) - [Secret management](https://yu-min3.github.io/kensan-lab/secret-management/index.md) ## Architecture decisions - [Architecture Decision Records](https://yu-min3.github.io/kensan-lab/adr/index.md) - [001 — TLS Termination Pattern](https://yu-min3.github.io/kensan-lab/adr/001-tls-termination-pattern/index.md) - [002 — Authentication & Authorization](https://yu-min3.github.io/kensan-lab/adr/002-authentication-authorization-architecture/index.md) - [003 — ApplicationSet Migration](https://yu-min3.github.io/kensan-lab/adr/003-applicationset-migration-strategy/index.md) - [004 — Network Policy Design](https://yu-min3.github.io/kensan-lab/adr/004-network-policy-design/index.md) - [005 — Istio Native OAuth2](https://yu-min3.github.io/kensan-lab/adr/005-istio-native-oauth2/index.md) - [006 — Namespace Naming](https://yu-min3.github.io/kensan-lab/adr/006-namespace-naming/index.md) - [007 — No Vault PKI](https://yu-min3.github.io/kensan-lab/adr/007-no-vault-pki/index.md) - [008 — Keycloak DB Credentials](https://yu-min3.github.io/kensan-lab/adr/008-keycloak-db-credentials/index.md) - [009 — Shared Allow-Istio NetworkPolicy](https://yu-min3.github.io/kensan-lab/adr/009-shared-allow-istio-network-policy/index.md) - [010 — Istio Native OAuth2 (Absent)](https://yu-min3.github.io/kensan-lab/adr/010-istio-native-oauth2-absent/index.md) - [011 — Vault Version Pinning](https://yu-min3.github.io/kensan-lab/adr/011-vault-version-pinning/index.md) - [012 — Policy Enforcement with Kyverno](https://yu-min3.github.io/kensan-lab/adr/012-policy-enforcement-kyverno/index.md) - [013 — Keycloak DB Credentials → Vault Dynamic](https://yu-min3.github.io/kensan-lab/adr/013-keycloak-db-credentials-vault-dynamic/index.md) - [014 — Namespace Naming & Label Contract v2](https://yu-min3.github.io/kensan-lab/adr/014-namespace-naming-label-contract-v2/index.md) - [015 — VCO + Setup-Script Hybrid](https://yu-min3.github.io/kensan-lab/adr/015-vco-setup-script-hybrid/index.md) - [016 — LAN-Frictionless + External-Gate Model](https://yu-min3.github.io/kensan-lab/adr/016-lan-frictionless-cf-access-external-gate/index.md) - [017 — Remove kensan-legacy (tag archive)](https://yu-min3.github.io/kensan-lab/adr/017-kensan-legacy-removal/index.md) - [018 — Backstage Manifests Placement](https://yu-min3.github.io/kensan-lab/adr/018-backstage-manifests-placement/index.md) - [019 — Keycloak DB Credentials → Revert to Static](https://yu-min3.github.io/kensan-lab/adr/019-keycloak-db-credentials-revert-to-static/index.md) - [020 — Namespace Lifecycle App Cleanup](https://yu-min3.github.io/kensan-lab/adr/020-namespace-lifecycle-app-cleanup/index.md) - [021 — gateway-prod Default-Protected Authorization](https://yu-min3.github.io/kensan-lab/adr/021-gateway-prod-default-protected/index.md) - [022 — Backstage Native OIDC](https://yu-min3.github.io/kensan-lab/adr/022-backstage-native-oidc/index.md) ## Bare-metal bootstrap - [Prerequisites](https://yu-min3.github.io/kensan-lab/getting-started/installation/index.md) - [Configuration](https://yu-min3.github.io/kensan-lab/getting-started/configuration/index.md) - [Status and scope](https://yu-min3.github.io/kensan-lab/bootstrapping/index.md) - [Add worker node (M4 Neo)](https://yu-min3.github.io/kensan-lab/bootstrapping/add-worker-node-m4neo/index.md) - [Grafana independent setup](https://yu-min3.github.io/kensan-lab/bootstrapping/grafana-independent/index.md) - [Keycloak bootstrap](https://yu-min3.github.io/kensan-lab/bootstrapping/keycloak-bootstrap/index.md) - [Vault root of trust (Terraform)](https://yu-min3.github.io/kensan-lab/bootstrapping/vault-root-of-trust/index.md) - [Stage 1 — Vault HA](https://yu-min3.github.io/kensan-lab/bootstrapping/vault-stage1/index.md) ## Operations - [Runbooks](https://yu-min3.github.io/kensan-lab/runbooks/index.md) - [ArgoCD repo-server tuning](https://yu-min3.github.io/kensan-lab/runbooks/argocd-repo-server-tuning/index.md) - [Cilium update strategy](https://yu-min3.github.io/kensan-lab/runbooks/cilium-update-strategy/index.md) - [Cilium WiFi stability](https://yu-min3.github.io/kensan-lab/runbooks/cilium-wifi-stability/index.md) - [Longhorn restore test](https://yu-min3.github.io/kensan-lab/runbooks/longhorn-restore-test/index.md) - [OTel integration & troubleshooting](https://yu-min3.github.io/kensan-lab/runbooks/observability-integration/index.md) - [Vault Raft auto-join](https://yu-min3.github.io/kensan-lab/runbooks/vault-raft-join/index.md) - [Vault storage migration (Longhorn)](https://yu-min3.github.io/kensan-lab/runbooks/vault-storage-migration-longhorn/index.md) - [VCO drift after Vault rebuild](https://yu-min3.github.io/kensan-lab/runbooks/vco-vault-state-drift/index.md) - [Raspberry Pi WiFi stabilization](https://yu-min3.github.io/kensan-lab/runbooks/wifi-stabilization/index.md) - [Workspace volume recovery](https://yu-min3.github.io/kensan-lab/recovery/kensan-workspace-volume-recovery/index.md) - [Syncthing pairing recovery](https://yu-min3.github.io/kensan-lab/recovery/syncthing-pairing-recovery/index.md) - [Incidents](https://yu-min3.github.io/kensan-lab/incidents/index.md) - [2026-03-02 system-infra Sync Blocked](https://yu-min3.github.io/kensan-lab/incidents/2026-03-02-system-infra-sync-blocked/index.md) ## Reference - [Reference](https://yu-min3.github.io/kensan-lab/reference/index.md) - [Documentation Layout](https://yu-min3.github.io/kensan-lab/reference/doc-layout/index.md) - [Overview](https://yu-min3.github.io/kensan-lab/design/index.md) - [Adoption Status](https://yu-min3.github.io/kensan-lab/design/adoption-status/index.md) - [Components](https://yu-min3.github.io/kensan-lab/design/components/index.md) - [Patterns](https://yu-min3.github.io/kensan-lab/design/patterns/index.md) - [Brand Assets](https://yu-min3.github.io/kensan-lab/design/brand/index.md) - [Storage (local-path → Longhorn) — done](https://yu-min3.github.io/kensan-lab/roadmap/storage-longhorn/index.md) - [Articles](https://yu-min3.github.io/kensan-lab/articles/index.md)