abhi1693/homelab

This repository documents and operates a home server cluster built on Raspberry Pi computers running ARM64 chips. The cluster uses Kubernetes (specifically a lightweight distribution called K3s) to run self-hosted applications including media management, home automation, databases, monitoring, and developer workspaces. Everything is managed through code: Ansible handles the initial setup of each node and the cluster bootstrap, and Rancher Fleet handles ongoing application deployment by reading Git as the source of truth. The design covers the full path from bare hardware to running applications. That includes how nodes are prepared and joined into a cluster, how networking is set up with Cilium (which handles traffic routing, load balancing, and network policies), how storage is provided through Longhorn, how shared services like PostgreSQL and a Redis-compatible cache are made available to applications, and how secrets are managed with SOPS. Applications are organized into separate Rancher projects (applications, media, home automation, databases, system services, and developer tools) so that a problem in one area does not cascade into others. The repository explicitly describes itself as a reference implementation rather than a one-command installer. It shows how a small Kubernetes environment can be layered and structured, but it does not pretend to handle site-specific details like your home network configuration, domain names, or hardware inventory. The README is exceptionally detailed, covering topology diagrams, traffic models, storage design, and the reasoning behind specific technology choices like why Cilium was selected over simpler networking options. One notable inclusion is Coder, a tool for running cloud-style developer workspaces inside the homelab, with HCL templates for defining workspace environments. The README is lengthy and the full content was not provided. The license is not mentioned in the available portion of the README.