chris-os docs

One person. One Pi. 37 containers. A personal AI infrastructure built solo: PostgreSQL, n8n, MCP, Caddy, Home Assistant, voice pipeline, semantic memory, and a React dashboard, all running on a Raspberry Pi 5.

Understand the System Operate the System

What is chris-os?

chris-os is a personal infrastructure monorepo. 37 Docker containers run on a Raspberry Pi 5 in a network closet, handling everything from email classification and health data imports to voice commands and semantic memory for AI assistants. One PostgreSQL database with 210 tables serves as the single source of truth. 80 n8n workflows automate data flows. 14 MCP servers expose 611 tools to Claude and other AI assistants. A full observability stack (Grafana, Prometheus, Loki, Tempo) monitors every container.

One person built all of it.

Start Here

Architecture Overview and How to Read These Docs. Understand what chris-os is and how the pieces fit together.

Concepts

Local-First AI, Privacy Tiers, PostgreSQL as Source of Truth, and The Agent Protocol. The design philosophy and architectural patterns.

Systems

PostgreSQL, n8n, MCP Layer, Auth & Networking, Monitoring, Dashboard, Home Assistant, and Voice Pipeline. Per-service documentation for every major subsystem.

Operations

Deployment procedures, database migrations, backup and restore, container management, and incident runbooks.

Decisions

Architecture Decision Records capturing the context and reasoning behind major architectural choices.