HaLOS Documentation

Welcome to the documentation for HaLOS (Hat Labs Operating System) — a container-first operating system for Raspberry Pi.

HaLOS provides a complete web-managed platform with single sign-on, a curated app store, and easy system administration. It is built on Debian and designed for both general-purpose and marine computing use cases.

Quick links

• Quick Start — Get HaLOS running in minutes
• Choosing an Image — Pick the right image for your hardware and use case
• User Guide — Learn how to use the web interface
• Architecture — Understand how HaLOS works under the hood
• Developer Guide — Contribute to HaLOS development

Features

• Web Management — Cockpit-based system administration with HaLOS branding
• Single Sign-On — Authelia-powered authentication across all services
• Container Apps — Install and manage applications from a curated store
• Reverse Proxy — Traefik routes traffic to services with automatic TLS
• Dashboard — Homarr provides a unified launcher for all installed apps
• Marine Integration — Optional Signal K, InfluxDB, and Grafana stack for boat systems