How home-assistant/operating-system works
Hardware Layer
• Supported hardware platforms (Raspberry Pi, ODROID, x86-64, etc.)
• Bootloader separation (UEFI/GRUB for x86-64, U-Boot for ARM devices)
Operating System Layer
• Buildroot-based Linux core
• File System Structure:
• SquashFS (read-only root)
• ZRAM for temporary storage (/tmp, /var)
• Overlay file system for persistence
• Kernel features (AppArmor, ZRAM)
Container Platform
• Docker Engine as the primary container runtime
• Containerd for container management
• Container networking bridge
Application Layer
• Home Assistant Supervisor (primary container)
• Home Assistant Core (managed by Supervisor)
• -ons (containerized applications)
Update/Security System
• RAUC update system
• A/B partition scheme for updates
• AppArmor security module
Layer Organization (bottom to top)
• [Hardware Layer]
• ↑
• [Bootloader Layer (UEFI/U-Boot)]
• ↑
• [Operating System Layer]
• ↑
• [Container Platform]
• ↑
• [Application Layer]
Connection Types
• Double lines: Data flow
Important Details
• File system mount points
• Network interfaces
• Update paths
• Security boundaries
A/B partition scheme for updates
• [Boot] → [System A] ↔ [RAUC] ↔ [System B]
Overlay system
• [Read-only Root] → [Overlay] → [Runtime FS]
Container isolation
• [Docker Engine]
• [Supervisor Container]
• [Home Assistant Container]
• [Add-on Containers]
Document mount points
• /mnt/boot
• /mnt/data
• /mnt/overlay
• Various bind mounts
Remember to include version compatibility information and system requirements in supplementary documentation.