Skip to content

Architecture Decision Records

Architecture Decision Records (ADRs) capture the context, decision, and consequences for significant choices in the chris-os monorepo. Each follows the format: Status / Context / Decision / Consequences.

ADRDecisionPage
ADR-001Pi 5 as primary production hostWhy a Raspberry Pi 5 in Production
ADR-002PostgreSQL for everything, including vectorsWhy PostgreSQL for Everything
ADR-009Docker Compose over KubernetesWhy Docker Compose, Not Kubernetes
ADR-010Fastify for the dashboard APIWhy Fastify for the Dashboard API
  • ADR-003: MCP layer architecture (proxy + auth + memory bridge)
  • ADR-004: Starlight for public documentation (this site)
  • ADR-005: Authelia SSO on .ataraxis.cloud cookie domain
  • ADR-006: Memory server embedding model: qwen3-embedding:8b at 4096 dims
  • ADR-007: Pagefind for static search (no external search API required)
  • ADR-008: Binary quantized HNSW vectors for memory server scale